Skip to main content
Triggers run an action when something happens in your program. A webhook trigger sends a request to your URL, so your systems learn about new affiliates, conversions or commissions without polling the API.

​
Events

Most events have filters, so the webhook fires only when conditions match, for example only for one program or only when an affiliate initiated the event. Open Add filter in the trigger to see the filters of an event.

​
Set up a webhook

1

Create a trigger

Open Triggers in your dashboard and click New trigger. Choose the event.
2

Add filters

Optional. Narrow down when the trigger fires.
3

Choose the webhook type

  • Webhook sends the object in the same format as the API reference, for example a conversion for Conversion created.
  • Webhook (custom) lets you compose the request yourself. Use merge tags from the {…} menu next to the field to insert event data.
4

Save

The webhook starts firing on the next matching event.
Track a test conversion after saving, to see the payload arrive at your endpoint.

​
Handling webhooks

  • Respond with a 2xx status quickly and do the work asynchronously.
  • Make your handler idempotent: use the object’s id to skip events you have already processed.
  • Use the REST API to fetch the current state of an object when you need more than the payload.