API Integration

Track referrals server-side with the FirstPromoter Tracking API

Difficulty: Intermediate
Developer Required: Yes

With the FirstPromoter Tracking API you can track signups, sales, refunds, and cancellations directly from your backend — no JavaScript required.

Available endpoints:

Endpoint	Purpose
POST /api/v1/track/signup	Track a lead sign-up
POST /api/v1/track/sale	Track a sale and generate a commission
POST /api/v1/track/refund	Track a refund and reverse a commission
POST /api/v1/track/cancellation	Track a subscription cancellation

See the Tracking API reference for full parameter documentation including deduplication via event_id, recurring commission scheduling, and custom fields.

Click here to view the in-app setup guide.