Webhooks

Met webhooks kunt u toestemmingsgebeurtenissen ontvangen als HTTP POST-verzoeken naar uw eigen eindpunt. Gebruik webhooks om de toestemmingsstatus te synchroniseren met uw backend, CRM of datawarehouse.

Een webhook instellen

1. Ga naar Dashboard → Property → Webhooks → Eindpunt toevoegen
2. Voer uw eindpunt-URL in (moet HTTPS zijn)
3. Selecteer welke gebeurtenissen u wilt ontvangen
4. Kopieer uw webhookgeheim (gebruikt voor handtekeningverificatie)
5. Opslaan

Gebeurtenissen

Gebeurtenis	Trigger
consent.created	Gebruiker geeft voor het eerst toestemming
consent.updated	Gebruiker wijzigt zijn toestemmingskeuzes
consent.expired	Opgeslagen toestemming bereikt vervaldatum
consent.reset	Toestemmingsreset op property-niveau toegepast

Payload-formaat

{
  "event": "consent.created",
  "delivery_id": "del_abc123",
  "timestamp": "2026-03-09T12:00:00Z",
  "property_id": "prop_xyz",
  "data": {
    "receipt_id": "rec_def456",
    "policy_id": "pol_ghi789",
    "policy_version": 3,
    "choices": {
      "necessary": true,
      "analytics": true,
      "marketing": false,
      "functional": true
    },
    "region": "DE",
    "user_agent_hash": "sha256:abc...",
    "ip_hash": "sha256:def..."
  }
}

Handtekeningen verifiëren

Verifieer altijd de header X-ConsentForge-Signature voordat u verwerkt. Zie Webhookbeveiliging voor codevoorbeelden.

Webhooks testen

Gebruik de knop Testen in de webhookinstellingen van het Dashboard om een voorbeeldpayload naar uw eindpunt te sturen. U kunt ook webhook.site gebruiken voor lokaal testen.

Afleveringsgeschiedenis bekijken

Dashboard → Property → Webhooks → Afleveringslogboek toont alle afleveringspogingen met statuscodes en antwoordteksten.