> This page is for Developer. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.bigcommerce.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server. # B2B Edition Webhooks B2B Edition is BigCommerce’s all-in-one solution that offers enterprise-level B2B functionality to businesses of all types and sizes. It enables business owners to facilitate their B2B operations online and to provide customers with self-service account capabilities and seamless transactions. This page is a reference for B2B Edition webhooks and it assumes that you're familiar with webhooks. For a general introduction to webhooks, see [Webhooks Overview](/developer/docs/integrations/webhooks). **Note:** B2B Edition currently does not support storefront channel-specific webhooks. ## Creating a webhook To create a webhook, send a request to the [Create a webhook](/developer/api-reference/rest/integrations/webhooks/create-webhooks) endpoint. You must use a BigCommerce store- or app-level API account to authenticate the request; it does not support the API tokens created in your [B2B Edition API Account settings](https://support.bigcommerce.com/s/article/B2B-Edition-Settings). Your API account must have the **B2B Edition** scope set to *modify*. The following example creates a webhook that subscribes to creation events for Company accounts. **`Example request: Create a webhook`** ```http title="Example request: Create a webhook" showLineNumbers={false} POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/v3/hooks X-Auth-Token: {{ACCESS_TOKEN}} Content-Type: application/json Accept: application/json { "scope": "store/company/created", "destination": "https://example.com/webhooks", // replace with your HTTPS endpoint URL "is_active": true } ``` > **Note** > > * The `destination` URL must be served on port **443**; custom ports are not currently supported. > * It can take up to one minute for a newly created webhook to work. For information on creating a webhook, consult the [creating a webhook section of the Webhooks Overview](/developer/docs/integrations/webhooks#creating-a-webhook). ## Callback structure For information on webhook callback payload properties, see [Webhook Events](/developer/docs/integrations/webhooks/event-reference#callback-structure). ## Companies The following webhooks fire in response to changes to Company account records. You can use them to track new Company account requests across your storefront channels, updates to Company information, or changes in a Company's activity status. | Name / Scope | Description | | :-------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | store/company/created | Fires when a new Company account is created in the storefront, from the B2B Edition control panel, or via the Server to Server API. Note that this webhook does not fire when the REST Management [Bulk Create Companies](/developer/api-reference/rest/b2b/management/company/companies/post-companies-bulk) endpoint is used. | | store/company/updated | Fires when a Company’s basic information is updated, including: - Company name - Email address - Phone number - Assigned customer group ID (Must be using [Independent Companies](https://support.bigcommerce.com/s/article/Companies-and-Customer-Groups) behavior) - Legal address - UUID - Activity status - Parent Company (Must be using [Account Hierarchy](https://support.bigcommerce.com/s/article/B2B-Edition-Account-Hierarchy)) - Assigned price list (Must be using Dependent Companies behavior) - Company extra field values | | store/company/deleted | Fires when a Company account is deleted from the B2B Edition control panel or via the API. | | store/company/statusUpdated | Fires when a Company's activity status changes, such as when a pending Company account is approved. | **`Example Company created payload object`** ```json title="Example Company created payload object" showLineNumbers={false} { "scope": "store/company/created", "store_id": "123456", "data": { "company_id": 1234 }, "hash": "352e4afc6dd3fc85ea26bfdf3f91852604d57528", "created_at": 1561482670, "producer": "stores/{store_hash}" } ``` ## Company Users The following webhooks fire in response to changes to Company users. These are B2B customers with a Buyer Portal account connected to a Company. Changes to B2C customers, guest shoppers, and Super Admins do not trigger these webhooks. | Name / Scope | Description | | :----------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- | | store/company/user/created | Fires when a new Company user is created in the storefront, from the B2B Edition control panel, or via the API. | | store/company/user/updated | Fires when a Company user's account information is updated, including: - User name - Email address - Phone number - Company user extra field values | | store/company/user/deleted | Fires when a Company user is deleted in the storefront, from the B2B Edition control panel, or via the API. | | store/company/superadmin/assignmentUpdated | Fires when a Super Admin is assigned to or unassigned from a Company. | **`Example Company user created payload object`** ```json title="Example Company user created payload object" showLineNumbers={false} { "scope": "store/company/user/created", "store_id": "123456", "data": { "company_id": 123456, "user_id": 321 }, "hash": "352e4afc6dd3fc85ea26bfdf3f91852604d57528", "created_at": 1561482670, "producer": "stores/{store_hash}" } ``` ## Company Addresses The following webhooks fire in response to changes to addresses saved to Company accounts. Changes to addresses on B2C customer accounts use [Customers webhooks](/developer/docs/integrations/webhooks/event-reference) instead. | Name / Scope | Description | | :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------- | | store/company/address/created | Fires when a new Company address is saved to a Company in the storefront, from the B2B Edition control panel, or via the API. | | store/company/address/updated | Fires when any field on an existing Company address is updated, including Company address extra field values. | | store/company/address/deleted | Fires when a Company address is deleted in the storefront, from the B2B Edition control panel, or via the API. | **`Example Company address created payload object`** ```json title="Example Company address created payload object" showLineNumbers={false} { "scope": "store/company/address/created", "store_id": "123456", "data": { "company_id": 123456, "address_id": 1234 }, "hash": "352e4afc6dd3fc85ea26bfdf3f91852604d57528", "created_at": 1561482670, "producer": "stores/{store_hash}" } ``` ## Super Admins The following webhooks fire in response to changes to [Super Admins](/developer/api-reference/rest/b2b/management/super-admin), sales staff who assist Company users from the Buyer Portal. | Name / Scope | Description | | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | | store/superadmin/created | Fires when a new Super Admin is created the B2B Edition control panel or via the API. | | store/superadmin/updated | Fires when a Super Admin's account information is updated, including: - Email address - Name - Phone number - Assigned/Unassigned Company accounts | | store/superadmin/deleted | Fires when a Super Admin is deleted from the B2B Edition control panel or via the API. | | store/superadmin/assignmentUpdated | Fires when a Super Admin's Company assignments are updated. | **`Example Super Admin created payload object`** ```json title="Example Super Admin created payload object" showLineNumbers={false} { "scope": "store/superadmin/created", "store_id": "123456", "data": { "user_id": 1234 }, "hash": "352e4afc6dd3fc85ea26bfdf3f91852604d57528", "created_at": 1561482670, "producer": "stores/{store_hash}" } ``` ## Quotes The following webhooks fire in response to changes to quotes. You can use them to track quote lifecycle events such as creation, updates, status changes, and deletions. | Name / Scope | Description | | :------------------------ | :-------------------------------------- | | store/quote/created | Fires when a new quote is created. | | store/quote/updated | Fires when a quote is updated. | | store/quote/statusUpdated | Fires when a quote's status is changed. | | store/quote/deleted | Fires when a quote is deleted. | **`Example quote created payload object`** ```json title="Example quote created payload object" showLineNumbers={false} { "created_at": 1561482670, "store_id": "1025646", "producer": "stores/{store_hash}", "scope": "store/quote/created", "hash": "352e4afc6dd3fc85ea26bfdf3f91db8c86f74f09", "data": { "quote_id": 456, "quote_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" } } ``` ## Resources ### Related Articles * [Webhooks Overview](/developer/docs/integrations/webhooks) * [Webhook Events](/developer/docs/integrations/webhooks/event-reference) * [Webhooks Reference](/developer/docs/integrations/webhooks) * [B2B Edition Reference](/developer/api-reference/rest/b2b)