Webhooks

Overview

Webhooks send real-time HTTP POST requests to your server when events happen in Eventually. Use them to sync with your CRM, trigger automations, or update external systems.

Setup

Go to Settings > API & Webhooks
Click Add Webhook Endpoint
Enter your HTTPS endpoint URL
Select which events to subscribe to
Copy the signing secret (shown once)

Event Types

Event	Fires When
`registration.created`	A new guest registers
`registration.cancelled`	A registration is cancelled
`payment.completed`	A paid ticket checkout succeeds
`checkin.scanned`	A guest's QR code is scanned
`waitlist.joined`	A guest joins the waitlist
`ticket.refunded`	A ticket payment is refunded
`event.updated`	An event's details are changed
`resale.completed`	A ticket resale transfer completes

Payload Format

{
  "event": "registration.created",
  "timestamp": "2026-03-20T16:00:00Z",
  "data": {
    "registration_id": "uuid",
    "guest_id": "uuid",
    "event_id": "uuid",
    "status": "approved",
    "email": "guest@example.com",
    "name": "Jane Doe"
  }
}

Verifying Signatures

Every webhook includes an X-Webhook-Signature header with an HMAC-SHA256 signature:

X-Webhook-Signature: sha256=<hex_digest>
X-Webhook-Event: registration.created
X-Webhook-ID: <delivery_uuid>

Verify by computing HMAC-SHA256(raw_body, your_signing_secret) and comparing with the header value using a timing-safe comparison.

Retries

Failed deliveries (non-2xx response or timeout) are retried up to 3 times with exponential backoff: 1 minute, 5 minutes, 30 minutes.

Testing

Use the Test button next to each endpoint in Settings to send a sample payload and verify your endpoint is receiving events correctly.