Postback URLs

Get real-time GET notifications when referrals, sales, or commissions happen.

Postback URLs send a GET request to your URL when events happen — perfect for ad networks, trackers, or automations.

Quick Setup

Go to Settings → Postback in your affiliate portal
Click Add Postback URL
Pick your events, enter your URL with placeholders, save

Events

Event	Fires when…
`referral.lead`	New referral tracked
`referral.converted`	Referral becomes a customer
`sale.created`	Payment recorded
`commission.created`	Commission calculated

Placeholders

Insert these into your URL — they get replaced with real values:

Placeholder	Example
`{event_type}`	`commission.created`
`{referral_id}`	`ref_abc123`
`{tracking_id}`	`john`
`{affiliate_id}`	`aff_xyz789`
`{status}`	`CONVERTED`
`{sale_amount}`	`99.00`
`{sale_currency}`	`USD`
`{commission_amount}`	`12.50`
`{commission_currency}`	`USD`
`{transaction_id}`	`txn_123`
`{timestamp}`	`2026-03-05T10:30:45Z`

Example

Template:

https://tracker.com/pb?event={event_type}&rid={referral_id}&amount={commission_amount}

What gets sent:

https://tracker.com/pb?event=commission.created&rid=ref_abc123&amount=12.50

Testing

Click Send Test on any saved postback URL. You'll see the HTTP status code and response time instantly.

Limits

Max 5 postback URLs
HTTPS only
10s timeout per request
Up to 3 delivery attempts with exponential backoff (5 s → 30 s)

Was this article helpful?