Shopify shipping webhook events

Shopify sends 6 shipping events, including delivery_promise_settings/update, profiles/create and profiles/delete. 4 have sample payloads.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

delivery_promise_settings/update

documented from Shopify docs (example)

Delivery promise setting changes

Identified by x-shopify-topic header Resource shipping

shopify-delivery-promise-settings-update.json
{
  "shop_id": "gid://shopify/Shop/548380009",
  "processing_time": "P2D",
  "delivery_dates_enabled": true
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

profiles/create

documented from Shopify docs (example)

New delivery profile created

Identified by x-shopify-topic header Resource shipping

shopify-profiles-create.json
{
  "id": 1
}

Key fields

Field Type Example
id integer 1

Full schema: 6 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

profiles/delete

documented from Shopify docs (example)

Delivery profile is deleted

Identified by x-shopify-topic header Resource shipping

shopify-profiles-delete.json
{
  "id": 1
}

Key fields

Field Type Example
id integer 1

Full schema: 6 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

profiles/update

documented from Shopify docs (example)

Delivery profile changes

Identified by x-shopify-topic header Resource shipping

shopify-profiles-update.json
{
  "id": 1
}

Key fields

Field Type Example
id integer 1

Full schema: 6 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

shipping_addresses/create

documented No payload yet

New shipping address created

Identified by x-shopify-topic header Resource shipping

No payload yet.

Help fill this in → View as JSON

shipping_addresses/update

documented No payload yet

Shipping address changes

Identified by x-shopify-topic header Resource shipping

No payload yet.

Help fill this in → View as JSON

Route Shopify events by type.

Event Gateway receives every Shopify delivery and filters and routes it by event type, so each service gets only the events it handles.

Not affiliated with Shopify. Facts are compiled from public sources and linked inline.