Sequifi

Webhooks

Webhooks notify your application when events happen in your account, so you don't need to poll the API.

How webhooks work

  1. Register a URL in the Dashboard under Settings → Webhooks.
  2. When an event occurs, we send an HTTP POST to your URL with a JSON payload.
  3. Your endpoint should respond with 200 OK quickly. Process asynchronously if needed.

Event payload

Each request includes a signed payload and headers for verification:

{
  "id": "evt_123",
  "type": "resource.created",
  "created_at": "2024-01-15T12:00:00Z",
  "data": {
    "id": "res_abc",
    "object": "resource",
    "name": "Example"
  }
}

Verifying signatures

Use the Sequifi-Signature header and your webhook signing secret to verify that the request came from Sequifi. Compute HMAC SHA-256 of the raw body and compare with the header value.

Retries

If your endpoint does not return 200, we retry with exponential backoff for up to 72 hours.

API Reference →