Shopify companies webhook events

Shopify sends 11 companies events, including companies/create, companies/delete and companies/update.

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

companies/create

verified from a captured delivery

New company created

Identified by x-shopify-topic header Resource companies

shopify-companies-create.json
{
  "name": "Example Company",
  "note": "This is an example company",
  "external_id": "123456789",
  "main_contact_admin_graphql_api_id": "gid://shopify/CompanyContact/408372092144951652",
  "created_at": "2021-12-31T19:00:00-05:00",
  "updated_at": "2021-12-31T19:00:00-05:00",
  "customer_since": "2021-12-31T19:00:00-05:00",
  "admin_graphql_api_id": "gid://shopify/Company/408372092144951419"
}

Key fields

Field Type Example
created_at string 2021-12-31T19:00:00-05:00

Full schema: 8 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-triggered-at , x-shopify-webhook-id

Send example to Inspect → View as JSON

companies/delete

verified from a captured delivery

Company is deleted

Identified by x-shopify-topic header Resource companies

shopify-companies-delete.json
{
  "name": "Example Company",
  "note": "This is an example company",
  "external_id": "123456789",
  "main_contact_admin_graphql_api_id": "gid://shopify/CompanyContact/408372092144951652",
  "created_at": "2021-12-31T19:00:00-05:00",
  "updated_at": "2021-12-31T19:00:00-05:00",
  "customer_since": "2021-12-31T19:00:00-05:00",
  "admin_graphql_api_id": "gid://shopify/Company/408372092144951419"
}

Key fields

Field Type Example
created_at string 2021-12-31T19:00:00-05:00

Full schema: 8 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-triggered-at , x-shopify-webhook-id

Send example to Inspect → View as JSON

companies/update

verified from a captured delivery

Company details change

Identified by x-shopify-topic header Resource companies

shopify-companies-update.json
{
  "name": "Example Company",
  "note": "This is an example company",
  "external_id": "123456789",
  "main_contact_admin_graphql_api_id": "gid://shopify/CompanyContact/408372092144951652",
  "created_at": "2021-12-31T19:00:00-05:00",
  "updated_at": "2021-12-31T19:00:00-05:00",
  "customer_since": "2021-12-31T19:00:00-05:00",
  "admin_graphql_api_id": "gid://shopify/Company/408372092144951419"
}

Key fields

Field Type Example
created_at string 2021-12-31T19:00:00-05:00

Full schema: 8 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-triggered-at , x-shopify-webhook-id

Send example to Inspect → View as JSON

company_contact_roles/assign

documented from Shopify docs (example)

Role assigned to a company contact at a location

Identified by x-shopify-topic header Resource companies

shopify-company-contact-roles-assign.json
{
  "company_contact": { … },
  "company_location": { … },
  "company_contact_role": { … }
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

company_contact_roles/revoke

documented from Shopify docs (example)

Role revoked from a company contact at a location

Identified by x-shopify-topic header Resource companies

shopify-company-contact-roles-revoke.json
{
  "company_contact": { … },
  "company_location": { … },
  "company_contact_role": { … }
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

company_contacts/create

documented from Shopify docs (example)

New company contact created

Identified by x-shopify-topic header Resource companies

shopify-company-contacts-create.json
{
  "customer_admin_graphql_api_id": "gid://shopify/Customer/12123842227812391",
  "title": "Buyer",
  "locale": "en",
  "created_at": "2021-12-31T19:00:00-05:00",
  "updated_at": "2021-12-31T19:00:00-05:00",
  "admin_graphql_api_id": "gid://shopify/CompanyContact/408372092144951419",
  "company": { … }
}

Key fields

Field Type Example
created_at string 2021-12-31T19:00:00-05:00

Full schema: 15 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

company_contacts/delete

documented from Shopify docs (example)

Company contact is deleted

Identified by x-shopify-topic header Resource companies

shopify-company-contacts-delete.json
{
  "customer_admin_graphql_api_id": "gid://shopify/Customer/12123842227812391",
  "title": "Buyer",
  "locale": "en",
  "created_at": "2021-12-31T19:00:00-05:00",
  "updated_at": "2021-12-31T19:00:00-05:00",
  "admin_graphql_api_id": "gid://shopify/CompanyContact/408372092144951419",
  "company": { … }
}

Key fields

Field Type Example
created_at string 2021-12-31T19:00:00-05:00

Full schema: 15 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

company_contacts/update

documented from Shopify docs (example)

Company contact details change

Identified by x-shopify-topic header Resource companies

shopify-company-contacts-update.json
{
  "customer_admin_graphql_api_id": "gid://shopify/Customer/12123842227812391",
  "title": "Buyer",
  "locale": "en",
  "created_at": "2021-12-31T19:00:00-05:00",
  "updated_at": "2021-12-31T19:00:00-05:00",
  "admin_graphql_api_id": "gid://shopify/CompanyContact/408372092144951419",
  "company": { … }
}

Key fields

Field Type Example
created_at string 2021-12-31T19:00:00-05:00

Full schema: 15 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

company_locations/create

documented from Shopify docs (example)

New company location created

Identified by x-shopify-topic header Resource companies

shopify-company-locations-create.json
{
  "name": "Montreal",
  "external_id": "123456789",
  "phone": "555-555-5555",
  "locale": "en",
  "created_at": "2021-12-31T19:00:00-05:00",
  "updated_at": "2021-12-31T19:00:00-05:00",
  "note": "Head Office Location",
  "buyer_experience_configuration": null,
  "admin_graphql_api_id": "gid://shopify/CompanyLocation/408372092144951419"
}

Key fields

Field Type Example
created_at string 2021-12-31T19:00:00-05:00

Full schema: 61 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

company_locations/delete

documented from Shopify docs (example)

Company location is deleted

Identified by x-shopify-topic header Resource companies

shopify-company-locations-delete.json
{
  "name": "Montreal",
  "external_id": "123456789",
  "phone": "555-555-5555",
  "locale": "en",
  "created_at": "2021-12-31T19:00:00-05:00",
  "updated_at": "2021-12-31T19:00:00-05:00",
  "note": "Head Office Location",
  "buyer_experience_configuration": null,
  "admin_graphql_api_id": "gid://shopify/CompanyLocation/408372092144951419"
}

Key fields

Field Type Example
created_at string 2021-12-31T19:00:00-05:00

Full schema: 61 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

company_locations/update

documented from Shopify docs (example)

Company location details change

Identified by x-shopify-topic header Resource companies

shopify-company-locations-update.json
{
  "name": "Montreal",
  "external_id": "123456789",
  "phone": "555-555-5555",
  "locale": "en",
  "created_at": "2021-12-31T19:00:00-05:00",
  "updated_at": "2021-12-31T19:00:00-05:00",
  "note": "Head Office Location",
  "buyer_experience_configuration": null,
  "admin_graphql_api_id": "gid://shopify/CompanyLocation/408372092144951419"
}

Key fields

Field Type Example
created_at string 2021-12-31T19:00:00-05:00

Full schema: 61 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → 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.