WebhooksRespond to a webhook request

Webhooks

🔔 Webhook Delivery & Handling

✅ Successful Acknowledgment

A webhook delivery is considered successful when your system responds with an HTTP status code in the 2xx range (e.g., 200 OK).

Guidelines:

  • Always return a 2xx response after receiving and validating the webhook payload

  • Ensure your system processes the request within a reasonable time to avoid timeouts


❌ Failure Handling

A webhook delivery is considered failed when your system responds with a non-2xx status code.

What happens next:

  • The webhook will be marked as failed

  • The system may retry delivery based on the webhook retry policy