Manage Webhooks (Single)
Create a Webhook
POST https://api.bigcommerce.com/stores/{store_hash}/v3/hooksRequest
Creates a webhook. Only one webhook at a time can be created. Custom headers can be added. Destination URL must be served on port 443 (custom ports are not currently supported).
Authentication
- X-Auth-Token in header
Parameters
- store_hash in path - string
- Accept in header with default of application/json - string
- Content-Type in header with default of application/json - string
Body
object | application/json
scopestring
requiredEvent you subscribe to.Example: store/order/createddestinationstring
requiredURL must be active, return a 200 response, and be served on port 443. Custom ports arenʼt currently supported.Example: https://665b65a6.ngrok.io/webhooksis_activeboolean
Boolean value that indicates whether the webhook is active or not. A webhook subscription becomes deactivated after 90 days of inactivity.Example: trueheadersobject or null
Headers used to validate that webhooks are active. You can pass in any number of custom headers to validate webhooks are being returned.
example
Response
Body
object | application/json
dataobject
example
Get a Webhook
GET https://api.bigcommerce.com/stores/{store_hash}/v3/hooks/{webhook_id}Request
Return a webhook by ID.
Authentication
- X-Auth-Token in header
Parameters
- store_hash in path - string
- webhook_id in path - integerrequiredThe ID of a Webhook.Example: 22561593
- Accept in header with default of application/json - string
- Content-Type in header with default of application/json - string
example
Response
Example response
Body
object | application/json
dataobject
application/json
Update a Webhook
PUT https://api.bigcommerce.com/stores/{store_hash}/v3/hooks/{webhook_id}Request
Updates a webhook. You can add custom headers. At least one field is required to perform an update.
Authentication
- X-Auth-Token in header
Parameters
- store_hash in path - string
- webhook_id in path - integerrequiredThe ID of a Webhook.Example: 22561593
- Accept in header with default of application/json - string
- Content-Type in header with default of application/json - string
Body
object | application/json
scopestring
Event you subscribe to.Example: store/order/createddestinationstring
URL must be active, return a 200 response, and be served on port 443. Custom ports arenʼt currently supported.Example: https://665b65a6.ngrok.io/webhooksis_activeboolean
Boolean value that indicates whether the webhook is active or not.Example: trueheadersobject or null
Headers used to validate that webhooks are active. You can pass in any number of custom headers to validate webhooks are being returned.
example
Response
Example response
Body
object | application/json
dataobject
application/json
Delete a Webhook
DELETE https://api.bigcommerce.com/stores/{store_hash}/v3/hooks/{webhook_id}Request
Deletes a webhook. Only one webhook at a time can be deleted. When a webhook is deleted, it is returned in the response as a 200 OK.
Authentication
- X-Auth-Token in header
Parameters
- store_hash in path - string
- webhook_id in path - integerrequiredThe ID of a Webhook.Example: 22561593
- Accept in header with default of application/json - string
- Content-Type in header with default of application/json - string
example
Response
Example response
Body
object | application/json
dataobject
application/json
Did you find what you were looking for?