Skip to main content
Listen to events in your FirstPromoter account on your webhook endpoint so you can trigger actions or automate processes in your application.

​
Why webhooks

After setting up your FirstPromoter account, you may want to receive events in order to trigger an action or automate a process. Webhooks allow you to do this by pushing real-time event data to your endpoint as things happen in your account. If you are using a tool like Zapier, Albato, or Make, they provide webhook endpoints when creating an automation flow.

​
How to set it up

Navigate to Settings → Integrations and scroll down to the webhooks section. Add a webhook URL for each event you want to receive.

​
Payload structure

Every webhook event is sent as a POST request with a JSON body containing two top-level keys:
  • event — metadata about the event (id, type, timestamp)
  • data — the full payload for the event (lead, promoter, reward, etc.)

​
Available webhook events

​
How to respond

Your endpoint should return a 2xx HTTP status code to acknowledge receipt. If your endpoint does not respond in time or returns a non-2xx status, FirstPromoter will retry the delivery. The fulfilment_pending event has special response semantics — see its dedicated page for details.