Webhooks

Webhooks push events to your endpoint as things happen in your workspace — new tickets, replies, status changes — so you can sync to your own systems.

Create a webhook

1. Go to Admin → Developer Portal → Webhooks.
2. Add your HTTPS endpoint URL and select the events to subscribe to.
3. Save. AnswerRidge generates a signing secret for verifying payloads.

Events

• ticket.created, ticket.updated, ticket.status_changed
• ticket.reply_created
• conversation.created, conversation.assigned
• customer.created

Payload

POST https://your-app.com/webhooks/answerridge
X-AnswerRidge-Signature: t=1718000000,v1=<hmac-sha256>

{
  "event": "ticket.created",
  "created_at": "2026-06-11T15:00:00Z",
  "data": { "id": "...", "subject": "...", "status": "open" }
}

Verify the signature

Each request includes X-AnswerRidge-Signature: an HMAC-SHA256 of the raw body using your signing secret. Recompute it and compare before trusting the payload. Reject requests older than a few minutes to prevent replay.

Retries

Non-2xx responses are retried with exponential backoff. Make your handler idempotent by keying on the event id.