Skip to main content
The Referralful REST API lets you manage your affiliate program programmatically: create and update affiliates, read referrals and commissions, mark payouts as paid, and report conversions from any billing system, not just Stripe.

Base URL

https://api.referralful.com/v1
All requests are made over HTTPS. Responses are JSON.

Built to be Rewardful-compatible

If you already use Rewardful, switching is mostly a find-and-replace. The endpoints, object shapes, field names, authentication, and pagination match Rewardful’s REST API, so you change the base URL and your API key, and your existing code keeps working.

Switching from Rewardful?

See exactly what changes (the host and the key) and what stays the same (everything else).

Don’t use Stripe?

Stripe merchants get conversions tracked automatically. If you bill another way, report each sale with a single API call and Referralful runs it through the same commission engine.

Report conversions via API

Send a sale from your backend, attribute it to an affiliate, and create the commission.

Resources

ResourceDescription
CampaignsPrograms with their commission and cookie rules
AffiliatesThe people promoting you, with their links and coupons
Affiliate linksTracking links (tokens) for an affiliate
Affiliate couponsPromo codes tied to an affiliate
ReferralsVisitors, leads, and conversions an affiliate drove
CommissionsAmounts owed to affiliates per sale
PayoutsBatches of commissions paid out
ConversionsReport a sale from any billing system