insimbi

Docs · Webhooks

Webhooks

Events for every movement and every decision.

Designed. Webhooks, GET /v1/events and the event names below are designed. Access and security events are already written to the audit record; see Core concepts.

Every change becomes an event. Read them with GET /v1/events, or receive them at your webhook endpoints.

DeliveriesOne delivery per event per endpoint.
AttemptsEvery attempt is kept: status, timing, signing-key version.
ReplaysReplay any delivery. Replays are linked to the original.

Illustrative example

{
  "id": "evt_01J9b",
  "type": "payment.captured",
  "schema_version": "2026-10",
  "data": {
    "payment_id": "pay_01J9",
    "ticket_id": "tkt_01J9"
  }
}

Every delivery is signed. Retries back off. Each event has an id you can use to deduplicate.

An event, from the change to your endpoint Designed. Every change becomes an event. Each delivery is signed, retried with backoff and can be replayed.
An event, from the change to your endpointSequence diagram with 4 lanes (insimbi API and record, Events and deliveries, Your webhook endpoint, Your team or service) and 10 numbered steps. The same steps are listed in text below the diagram.insimbi APIand recordEvents anddeliveriesYour webhookendpointYour teamor service1A payment is captured and written tothe record2Emit payment.capturedwith an event id andschema_version3Deliver the event,signed. One deliveryper event perendpoint.4No 2xx in time: theattempt is kept withits status and timing5Retry with backoff,signed with thecurrent signing-keyversion62xx: delivered7Deduplicate on the event id beforeacting8GET/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/attempts9POST .../replays to replay a delivery. Thereplay is linked to the original.10GET /v1/events to read every event with cursorpagination

Steps in text

  1. insimbi API and record: A payment is captured and written to the record
  2. insimbi API and record to Events and deliveries: Emit payment.captured with an event id and schema_version
  3. Events and deliveries to Your webhook endpoint: Deliver the event, signed. One delivery per event per endpoint.
  4. Your webhook endpoint to Events and deliveries: No 2xx in time: the attempt is kept with its status and timing
  5. Events and deliveries to Your webhook endpoint: Retry with backoff, signed with the current signing-key version
  6. Your webhook endpoint to Events and deliveries: 2xx: delivered
  7. Your webhook endpoint: Deduplicate on the event id before acting
  8. Your team or service to Events and deliveries: GET /v1/webhooks/{webhook_id}/deliveries/{delivery_id}/attempts
  9. Your team or service to Events and deliveries: POST .../replays to replay a delivery. The replay is linked to the original.
  10. Your team or service to Events and deliveries: GET /v1/events to read every event with cursor pagination