Enable BigCommerce Webhook
POST/api/big-commerce/:integrationInstance/webhooks/enable
Register a single webhook topic with the BigCommerce store so BigCommerce starts calling SKU.io for that event. SKU.io generates (or reuses) a per-instance shared secret that BigCommerce sends back on every delivery.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Authentication: Bearer token (Personal Access Token). Requires the integrations.update permission.
Body:
- scope (string, required): the topic to enable. One of: store/order/created, store/order/updated, store/product/created, store/product/updated, store/product/deleted, store/shipment/created, store/shipment/updated, store/inventory/order_level/updated, store/inventory/product/updated.
If the topic is already registered the call succeeds without contacting BigCommerce (message "Webhook is already enabled"). An unknown scope, or BigCommerce rejecting the registration, returns 422 with success false.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthorized
Response Headers
Forbidden
Response Headers
Not Found
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.