# 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](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)

## companies/create

Confidence: verified · Schema: from a captured delivery

New company created

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

```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 field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-12-31T19:00:00-05:00` |

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`

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

## companies/delete

Confidence: verified · Schema: from a captured delivery

Company is deleted

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

```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 field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-12-31T19:00:00-05:00` |

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`

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

## companies/update

Confidence: verified · Schema: from a captured delivery

Company details change

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

```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 field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-12-31T19:00:00-05:00` |

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`

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

## company_contact_roles/assign

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

Role assigned to a company contact at a location

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

```json
{
  "company_contact": { … },
  "company_location": { … },
  "company_contact_role": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/company-contact-roles-assign.json)

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/company-contact-roles-assign.json)

## company_contact_roles/revoke

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

Role revoked from a company contact at a location

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

```json
{
  "company_contact": { … },
  "company_location": { … },
  "company_contact_role": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/company-contact-roles-revoke.json)

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/company-contact-roles-revoke.json)

## company_contacts/create

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

New company contact created

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

```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": { … }
}
```

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

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

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

## company_contacts/delete

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

Company contact is deleted

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

```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": { … }
}
```

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

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

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

## company_contacts/update

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

Company contact details change

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

```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": { … }
}
```

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

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

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

## company_locations/create

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

New company location created

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

```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"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

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

## company_locations/delete

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

Company location is deleted

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

```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"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

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

## company_locations/update

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

Company location details change

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

```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"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/company-locations-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)
