Skip to main content

Idempotency

Use the event id and resource resourceId for idempotent processing:

Error Handling

Always return appropriate HTTP status codes:

Retry Handling

Tiro retries failed deliveries. Handle them based on your response status:
  • Return 2xx status codes for successful processing (no retry)
  • Return any non-2xx status code and we retry regardless of the status code (including 4xx), up to 5 times (6 attempts total)

Security

Always verify webhook authenticity:

Resource Routing

Route events with resourceType and resourceId: