Webhook FAQs

Start with these articles:

• Getting Started with Webhooks

• Developer Documentation

Webhook configurations can be disabled for two reasons:

1. New configurations are disabled by default to allow developers to verify their endpoints and webhook settings before we dispatch requests.

2. Your endpoint failed to accept requests for over 3 days. If it does not return a HTTP 200 response during our retry period, we automatically disable the webhook.

When a webhook enters a failed state and is disabled, it remains in that state until a request succeeds. You can re-enable it, and it will attempt to send the next event. However, if that event fails, the configuration will be disabled again.

Closely monitor your webhooks in a failed state to ensure they respond with a HTTP 2xx status code, allowing the configuration to return to a healthy state.

1. You'll need to verify that your endpoint isn't breaking. If you're subscribed to more than one topic for a single endpoint, it may help to isolate the topic that is causing issues to avoid other, unrelated topics from being rejected as well.

2. If it isn't already, disable your webhook to prevent more requests from being sent to it unnecessarily

3. If you've fixed the original issue and enabled your webhook again, you should monitor it closely at first to make sure that the next request succeeds.

We do not currently allow webhook configurations to be deleted. Instead, you'll have to disable the configuration, which prevents our system from sending further requests to that endpoint.

How do I enable/disable a webhook?

You can enable/disable webhooks using the Webhook Configuration Settings or by making an API call to update the configuration and set active: true

What topics can I subscribe to?

You can find our currently supported list of webhook topics here.

How do I re-trigger webhook requests?

We currently do not offer the ability to manually retrigger specific requests. That being said, if you've fixed a problem with your endpoint before the retry window is closed, our system will automatically retry requests that were queued before the outage. You can also manually perform the action that resulted in the request. For example, if you created a webhook for the product.selected topic, you can trigger a request by simply selecting a product after enabling your webhook again.

Will old requests be retried if a webhook is automatically disabled?

If your webhook was disabled because it failed to return a successful response during the retry window all past queued requests for it will be cancelled and will not be retried even after the webhook configuration is enabled again.