Webhooks

Webhooks ontvangen realtime events via HTTP POST naar een door jou geconfigureerde URL. Dezelfde events zijn ook beschikbaar via SSE. Webhooks zijn per organisatie geconfigureerd - elke organisatie heeft zijn eigen webhooks.

Beheer

Zie de OpenAPI-specificatie voor volledige request- en response-schema's.

Webhook aanmaken

POST /api/orgs/org_abc123/webhooks
Content-Type: application/json
x-api-key: tkn_xxx
X-Tillor-Org-Id: org_abc123

{
  "url": "https://jouw-server.com/webhooks/tillor",
  "subscribedEventKeys": ["invoice:created", "invoice:paid", "customer:updated"],
  "enabled": true
}

• url - HTTPS-endpoint die POST-requests accepteert
• subscribedEventKeys - Array van event keys of ["*"] voor alle events. De volledige lijst staat in Tillor onder Instellingen → Ontwikkelaars bij het aanmaken van een webhook.
• enabled - true om levering in te schakelen

Webhook-payload

Elke webhook-levering is een POST met:

Headers:

• Content-Type: application/json

Body:

{
  "event": "invoice:created",
  "data": {},
  "timestamp": 1735689600000
}

Zie Voorbeelden voor volledige payload-voorbeelden.

Leveringsgedrag en retries

• Geef een 2xx-status terug om succes te bevestigen
• Bij een mislukte levering (niet-2xx of netwerkfout) probeert Tillor automatisch tot 3 keer opnieuw met korte pauzes
• Na de retries wordt de levering gestopt

Event types

Event keys gebruiken het formaat entity:action of entity:subresource:action. Hieronder een selectie; de volledige lijst staat in Tillor onder Instellingen → Ontwikkelaars - in Tillor: Instellingen → Ontwikkelaars (per organisatie) bij het aanmaken van een webhook.

Webhooks vs SSE

Gerelateerd

• OpenAPI - Volledige API-specificatie
• HTTP API - REST API en API-sleutels
• SSE - Zelfde events via Server-Sent Events