How to set up a postback (S2S) as a publisher

A postback is an HTTP request Indoleads sends to your URL every time a conversion is created or changes status, so your tracker/CRM stays in sync without manual exports. One request per conversion event.

Global postback (all offers)

1. Settings → Postback → Add.
2. Paste your tracker's postback URL and insert macros by clicking them under the field. Common minimum:

https://your-tracker.com/postback?cid={p1}&status={status}&payout={payout_usd}&txid={conversion_id}
— where you passed your click ID in p1 when building the tracking link.

1. By events: Create only (one postback when the conversion is recorded) or Create and status update (also on every status change: pending → approved/declined/paid). Choose the second if your tracker handles status updates — most do.
2. Test — the platform fires a sample request; check it arrived in your tracker.
3. Save. Postback requests go to review; once approved you start receiving them.

Per-offer postback: offer page → Postback section → Add (same form). Useful when a tracker needs a different URL per offer.

Available tokens (click to insert): {conversion_id} {click_id} {status} (pending/approved/declined/paid) {payout} {payout_usd} {currency} {sale_amount} {sale_amount_usd} {txn_id} {offer_id}/{campaign_id} {offer_title}/{campaign_title} {p1}…{p4} {sub_publisher_id} {sub1}…{sub4} (advertiser's params) {conversion_date} {conversion_time} {conversion_datetime} (UTC+8) {click_time} {country_id} {ip} {agent} {referer} {publisher_id}/{aff_id} {advertiser_id}/{adv_id} {random}.

Tips

• Your endpoint must answer HTTP 200 on the first attempt — there are no retries. If your server was down, pull the missed conversions via the API /conversions.
• Statuses change over time (pending → approved), so expect several postbacks per conversion and update, don't insert twice.
• Don't put your API token in the postback URL.
• Bulk historical data? Use the Publisher API /conversions endpoint instead.

Advertiser integration (sending conversions to Indoleads) is a different thing — see Advertiser integration.