Referly API Reference

The Referly REST API lets you read and write affiliates, referrals, sales, links, coupons, and promotional codes, and attribute commissions from your own systems.

The Referly API lets you track payments and attribute commissions from your own systems. Everything you can do with affiliates, referrals, and sales in the dashboard, you can do here.

The API is a premium feature that’s only available to users who have an active Business Plan. See Pricing Page

Base URL

All endpoints are relative to:

https://www.referly.so/api/v1

Get started

Create your program

Create your Affiliate Program and add the tracking code to your website.

Authenticate

Generate an API key and authorize your requests with a Bearer token.

Every request carries your key as a Bearer token:

curl https://www.referly.so/api/v1/affiliates \
  -H "Authorization: Bearer <YOUR_TOKEN>"

Endpoints

Affiliates

The people promoting your program.

Referrals

The customers your affiliates brought in.

Sales

Purchases attributed to an affiliate.

Affiliate links

The referral links affiliates share.

Coupons

The discounts customers receive.

Promotional codes

The customer-facing codes tied to a coupon.

Concepts

Affiliates and referral links

Why affiliateLinks replaces the deprecated link property.

Coupons and promotional codes

How a coupon’s discount reaches a customer through a code.

Integrations

Zapier OAuth

Connect Referly to Zapier using OAuth.

Developer Documentation

Tracking, webhooks, and platform integrations.