# Shopify metafields webhook events

Shopify sends 6 metafields events, including `metafield_definitions/create`, `metafield_definitions/delete` and `metafield_definitions/update`. Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/shopify/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill shopify-webhooks` ([details](https://hookdeck.com/webhooks/shopify/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Shopify's official docs](https://shopify.dev/docs/apps/build/webhooks/delivery-structure).

[Overview](https://hookdeck.com/webhooks/shopify) · [Webhook events (230)](https://hookdeck.com/webhooks/shopify/events) · [MCP events](https://hookdeck.com/webhooks/shopify/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/shopify/verify) · [Production guide](https://hookdeck.com/webhooks/shopify/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/shopify/skill)

## metafield_definitions/create

Confidence: documented · Schema: from Shopify docs (example)

New metafield definition created

Identified by: x-shopify-topic header · Object: `metafields`

```json
{
  "id": null,
  "shop_id": 548380009,
  "namespace": "example-type",
  "key": "example-key",
  "name": "Example Field",
  "description": null,
  "owner_type": "Customer",
  "deleting": false
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/metafield-definitions-create.json)

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/metafield-definitions-create.json)

## metafield_definitions/delete

Confidence: documented · Schema: from Shopify docs (example)

Metafield definition is deleted

Identified by: x-shopify-topic header · Object: `metafields`

```json
{
  "id": "gid://shopify/MetafieldDefinition/1",
  "type": "ShopifyMetafields::Types::SingleLineTextFieldType",
  "created_by_app_id": null
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/MetafieldDefinition/1` |
| `type` | string | `ShopifyMetafields::Types::SingleLineTextFieldType` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/metafield-definitions-delete.json)

## metafield_definitions/update

Confidence: documented · Schema: from Shopify docs (example)

Metafield definition changes

Identified by: x-shopify-topic header · Object: `metafields`

```json
{
  "id": null,
  "shop_id": 548380009,
  "namespace": "example-type",
  "key": "example-key",
  "name": "Example Field",
  "description": null,
  "owner_type": "Customer",
  "deleting": false
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/metafield-definitions-update.json)

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/metafield-definitions-update.json)

## metaobjects/create

Confidence: documented · Schema: from Shopify docs (example)

New metaobject created

Identified by: x-shopify-topic header · Object: `metafields`

```json
{
  "type": "example-type",
  "handle": "example-metaobject",
  "created_at": "1975-10-31T00:55:12-05:00",
  "updated_at": "1985-07-13T01:55:12-04:00",
  "display_name": "Example Metaobject",
  "id": "gid://shopify/Metaobject/123",
  "definition_id": "gid://shopify/MetaobjectDefinition/222",
  "fields": { … },
  "created_by_staff_id": "gid://shopify/StaffMember/444",
  "created_by_app_id": "gid://shopify/ApiClient/333",
  "capabilities": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/metaobjects-create.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/Metaobject/123` |
| `type` | string | `example-type` |
| `created_at` | string | `1975-10-31T00:55:12-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/metaobjects-create.json)

## metaobjects/delete

Confidence: documented · Schema: from Shopify docs (example)

Metaobject is deleted

Identified by: x-shopify-topic header · Object: `metafields`

```json
{
  "id": "gid://shopify/Metaobject/123",
  "type": "example-type",
  "handle": "example-metaobject",
  "created_by_app_id": "gid://shopify/ApiClient/333"
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/Metaobject/123` |
| `type` | string | `example-type` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/metaobjects-delete.json)

## metaobjects/update

Confidence: documented · Schema: from Shopify docs (example)

Metaobject details change

Identified by: x-shopify-topic header · Object: `metafields`

```json
{
  "type": "example-type",
  "handle": "example-metaobject",
  "created_at": "1975-10-31T00:55:12-05:00",
  "updated_at": "1985-07-13T01:55:12-04:00",
  "display_name": "Example Metaobject",
  "id": "gid://shopify/Metaobject/123",
  "definition_id": "gid://shopify/MetaobjectDefinition/222",
  "fields": { … },
  "created_by_staff_id": "gid://shopify/StaffMember/444",
  "created_by_app_id": "gid://shopify/ApiClient/333",
  "capabilities": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/metaobjects-update.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/Metaobject/123` |
| `type` | string | `example-type` |
| `created_at` | string | `1975-10-31T00:55:12-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/metaobjects-update.json)

---

Not affiliated with Shopify. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/shopify.json) · [Report a correction](https://hookdeck.com/contact)
