Response Requirements

For a webhook delivery to be considered successful, your endpoint must:

• Return an HTTP 2xx status code (200-299 range)
  • We recommend using 200 OK or 204 No Content
  • Any 2xx status code will mark the delivery as successful
• Respond within 30 seconds
  • Webhooks that timeout will be retried according to the retry schedule
• Response body is optional
  • The response body content is ignored - you can return an empty response
  • There are no specific JSON or text requirements for the response body

Important: Any non-2xx status code (including 3xx redirects, 4xx client errors, and 5xx server errors) will trigger a retry according to the schedule above.

Example Successful Responses

// Minimal successful response
HTTP/1.1 200 OK

// With optional body (content is ignored)
HTTP/1.1 200 OK
Content-Type: application/json

{"status": "received"}

// No content response
HTTP/1.1 204 No Content