Best Practices

Return a 200 success response

Your endpoint should always acknowledge webhook requests with a 200 success response. Alloy interprets 4xx/5xx responses as a failure to deliver the webhook and will continue retrying until the webhook receives a success response or reaches the retry limit.

Process webhooks asynchronously

Your endpoint should respond to webhook requests quickly and then process the event asynchronously. Alloy webhooks have a 10-second timeout for the entire request. If a response is not received within 10 seconds, the request is considered failed and will be automatically retried.

Only subscribe to events your integration requires

Webhooks related to Journey changes are triggered by all of your Journeys and Journey application events by default. Alloy recommends specifying the Journeys and events that your integration should be notified about to prevent unnecessary webhook requests.