Webhookmeldingen

Ontvang realtime meldingen wanneer affiliates in je programma worden aangemaakt of gedeactiveerd, en wanneer een doorverwijzing in de app wordt geteld. Met webhooks synchroniseer je de status van affiliates automatisch met je eigen systemen, zonder dat polling nodig is.

Hoe het werkt

Wanneer een affiliate aan je bedrijf wordt toegevoegd of eruit wordt verwijderd, of wanneer een doorverwijzing in de app wordt geteld, stuurt Insert Affiliate een HTTP POST-verzoek met de details van het event naar de webhook-URL die je hebt ingesteld. Dit gebeurt automatisch op de achtergrond en vertraagt de bewerking op de affiliate niet.

Webhooks instellen

Ga naar Instellingen → tabblad Integraties
1. Scrol naar de sectie Webhookmeldingen
Vul je Webhook-URL in: deze moet HTTPS gebruiken
Vul optioneel een Bearer-token in: dit wordt meegestuurd in de header Authorization, zodat je server kan controleren of verzoeken echt van Insert Affiliate komen
Klik op Wijzigingen opslaan

Sectie Webhookmeldingen in de instellingen van het Insert Affiliate-dashboard

Klik om op volledige grootte te bekijken

Je bearer-token wordt versleuteld opgeslagen en wordt na het opslaan nooit meer volledig getoond.

Webhook-events

`affiliate.created`

Wordt verstuurd wanneer een affiliate aan je bedrijf wordt toegevoegd. Dit geldt voor alle manieren van aanmaken: handmatig een affiliate toevoegen vanuit het dashboard, een zelfaanmelding goedkeuren of het verzoek van een affiliate om lid te worden accepteren.

Payload:

{
  "event": "affiliate.created",
  "affiliate_id": "ia_45fee001",
  "email": "[email protected]",
  "deep_link": "https://myapp.link/ref/abc123",
  "occurred_at": "2026-03-18T12:00:00.000Z"
}

Velden:

Veld	Type	Beschrijving
`event`	string	Altijd `"affiliate.created"`
`affiliate_id`	string	Een deterministische identifier voor de affiliate, afgeleid van het e-mailadres. Formaat: `ia_` gevolgd door 8 hexadecimale tekens. Gelijk in alle events voor dezelfde affiliate.
`email`	string	Het e-mailadres van de affiliate
`deep_link`	string	De URL van de deeplink die aan de affiliate is toegewezen. Deze wordt meegestuurd wanneer er een deeplink is toegewezen (bijvoorbeeld bij het goedkeuren van een zelfaanmelding of het accepteren van een verzoek om lid te worden). Kan een lege string zijn als er nog geen deeplink is toegewezen.
`occurred_at`	string	ISO 8601-tijdstempel van het moment waarop het event plaatsvond

`affiliate.deactivated`

Wordt verstuurd wanneer een affiliate uit je bedrijf wordt verwijderd.

Payload:

{
  "event": "affiliate.deactivated",
  "affiliate_id": "ia_45fee001",
  "email": "[email protected]",
  "deep_link": "https://myapp.link/ref/abc123",
  "occurred_at": "2026-03-18T14:30:00.000Z"
}

Velden:

Veld	Type	Beschrijving
`event`	string	Altijd `"affiliate.deactivated"`
`affiliate_id`	string	Dezelfde deterministische identifier die in het `affiliate.created`-event voor deze affiliate is verstuurd. Gebruik deze om aanmaak- en deactivatie-events aan elkaar te koppelen.
`email`	string	Het e-mailadres van de affiliate
`deep_link`	string	De URL van de deeplink die op het moment van verwijderen aan de affiliate was toegewezen. Lege string als er geen deeplink was toegewezen.
`occurred_at`	string	ISO 8601-tijdstempel van het moment waarop het event plaatsvond

`referral.created`

Wordt verstuurd wanneer er iets gebeurt dat je doorverwijzingsprogramma in de app als doorverwijzing telt: een nieuwe aankoop, het event dat je hebt gekozen of een installatie, afhankelijk van je instelling. Wordt alleen verstuurd wanneer doorverwijzingen in de app zijn ingeschakeld, voor doorverwijzers die via je app zijn aangemeld.

Payload:

{
  "event": "referral.created",
  "affiliate_id": "ia_45fee001",
  "email": "[email protected]",
  "deep_link": "https://myapp.link/ref/abc123",
  "short_code": "a1b2c3d4",
  "trigger": "purchase",
  "referral_count": 3,
  "reward_status": "not_automatic",
  "occurred_at": "2026-09-18T12:00:00.000Z"
}

Velden:

Veld	Type	Beschrijving
`event`	string	Altijd `"referral.created"`
`affiliate_id`	string	Dezelfde identifier die in `affiliate.created` voor deze affiliate is verstuurd
`email`	string	Het e-mailadres van de doorverwijzer
`deep_link`	string	De link van de doorverwijzer, of diens shortcode bij bedrijven die alleen shortcodes gebruiken (Short Code Only)
`short_code`	string	De shortcode van de doorverwijzer
`trigger`	string	Wat er is geteld: `"purchase"`, `"event"` of `"install"`
`referral_count`	number	Het nieuwe lopende totaal van de doorverwijzer. Beloon tot dit aantal, zodat je nooit twee keer beloont en de volgende levering alles inhaalt wat je hebt gemist.
`reward_status`	string	Wat er met de automatische beloning gebeurde toen de doorverwijzing werd geregistreerd: `granted`, `not_automatic` (geen automatische beloning: beloon ze zelf als je Ik beloon ze zelf hebt gekozen), `waiting_for_account`, `waiting_for_codes` (wacht tot Apple aanbiedingscodes aanmaakt, of tot jij meer Google Play-promotiecodes uploadt; we proberen het elk uur opnieuw), `failed` of `capped` (boven de maandelijkse limiet, beloon deze niet). Wordt één keer verstuurd: een wachtende beloning die later wordt toegekend, verstuurt geen tweede webhook. Bekijk de volledige lijst.
`occurred_at`	string	ISO 8601-tijdstempel van het moment waarop het event plaatsvond

Authenticatie

Als je een bearer-token hebt ingesteld, bevat elk webhookverzoek de header:

Authorization: Bearer

Je server moet controleren of deze header overeenkomt met het token dat je in Insert Affiliate hebt ingesteld, om zeker te weten dat verzoeken legitiem zijn.

Opmerkingen over de werking

Fire-and-forget: het versturen van de webhook blokkeert de bewerking op de affiliate niet. Als je endpoint niet bereikbaar is of een fout teruggeeft, wordt de affiliate gewoon aangemaakt of verwijderd.
Alleen HTTPS: webhook-URL's moeten om veiligheidsredenen HTTPS gebruiken.
Time-out: verzoeken verlopen na 10 seconden. Zorg dat je endpoint snel reageert.
Geen nieuwe pogingen: mislukte webhooks worden niet opnieuw geprobeerd. Als betrouwbaarheid cruciaal is, kun je overwegen ontvangen events aan jouw kant te loggen en ze regelmatig te vergelijken met het Insert Affiliate-dashboard.
Consistente affiliate-ID's: de affiliate_id is deterministisch en gebaseerd op het e-mailadres van de affiliate. Hetzelfde e-mailadres levert altijd dezelfde affiliate_id op, zodat je created- en deactivated-events betrouwbaar aan elkaar kunt koppelen.

Voorbeelden van toepassingen

Synchroniseer affiliates met je CRM: maak automatisch contacten aan of archiveer ze wanneer affiliates zich aansluiten of vertrekken
Start onboarding-workflows: start een interne onboardingflow wanneer een nieuwe affiliate is goedgekeurd
Werk je eigen database bij: houd je gebruikersgegevens gesynchroniseerd met wijzigingen in de status van affiliates
Meldingen via Slack of e-mail: stuur events door naar een meldingskanaal voor je team