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
companies/create New company created
Identified by x-shopify-topic header
Resource companies
{
"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
companies/delete
verified from a captured delivery
companies/delete Company is deleted
Identified by x-shopify-topic header
Resource companies
{
"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
companies/update
verified from a captured delivery
companies/update Company details change
Identified by x-shopify-topic header
Resource companies
{
"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
company_contact_roles/assign
documented from Shopify docs (example)
company_contact_roles/assign Role assigned to a company contact at a location
Identified by x-shopify-topic header
Resource companies
{
"company_contact": { … },
"company_location": { … },
"company_contact_role": { … }
} From Shopify docs
-
Content type
application/json
company_contact_roles/revoke
documented from Shopify docs (example)
company_contact_roles/revoke Role revoked from a company contact at a location
Identified by x-shopify-topic header
Resource companies
{
"company_contact": { … },
"company_location": { … },
"company_contact_role": { … }
} From Shopify docs
-
Content type
application/json
company_contacts/create
documented from Shopify docs (example)
company_contacts/create New company contact created
Identified by x-shopify-topic header
Resource companies
{
"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
company_contacts/delete
documented from Shopify docs (example)
company_contacts/delete Company contact is deleted
Identified by x-shopify-topic header
Resource companies
{
"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
company_contacts/update
documented from Shopify docs (example)
company_contacts/update Company contact details change
Identified by x-shopify-topic header
Resource companies
{
"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
company_locations/create
documented from Shopify docs (example)
company_locations/create New company location created
Identified by x-shopify-topic header
Resource companies
{
"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
company_locations/delete
documented from Shopify docs (example)
company_locations/delete Company location is deleted
Identified by x-shopify-topic header
Resource companies
{
"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
company_locations/update
documented from Shopify docs (example)
company_locations/update Company location details change
Identified by x-shopify-topic header
Resource companies
{
"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
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.