Referrals that drive revenue.
Referrio is the referral & rewards layer for modern teams. Run it from a polished dashboard — upload users, log referrals, issue rewards by hand — or wire it all up through one clean API. Your call.
Everything a referral program needs.
Manage everything from the dashboard, or automate it through the API. Same data, your choice.
A referral code per user, generated on demand.
Human-readable, collision-free, branded to your domain. Issued the moment a user signs up.
Visits, signups & sales — counted automatically.
Configure rules per program. Triggered on sale criteria you set.
Prefer clicks over code? Run the whole program by hand.
Upload users from CSV, log a referral manually, issue a reward, or hand out a voucher — no engineer required.
Two ways. Same outcome.
Click through it in the dashboard, or wire it into your backend with four API calls. Mix and match whenever you like.
Create referrer
Add a user or upload a CSV from the Users page.
POST /users with an external id — we return a unique code.
Log event
Hit ‘Add referral’, paste the code, enter the sale.
POST /referrals with the code, type, and sale amount.
Evaluate
Active campaigns score the event automatically.
Same engine, same rules — triggered on every event.
Pay out
Approve cash payouts or assign vouchers in one click.
Or fully automate via webhooks and the rewards API.
A simple, developer-friendly Referral API.
Predictable JSON. Conventional verbs. Real HTTP status codes. Authenticate with one header and point your backend at our endpoint.
- ✓X-API-Key auth — rotatable per environment
- ✓Idempotent writes with request keys
- ✓Webhooks for every state transition
- ✓OpenAPI spec + Postman collection
$ curl -X POST https://api.referrio.co.uk/v1/users \
-H "X-API-Key: rk_live_…" \
-H "Content-Type: application/json" \
-d '{
"external_id": "cust_123",
"email": "jane@example.com",
"name": "Jane Doe"
}'
→ 201 Created
{
"referral_code": "JANE-A1B2C3",
"share_url": "https://yourshop.com/?r=JANE-A1B2C3"
}Core endpoints
The handful of routes you'll touch most often. Full reference in the OpenAPI spec.
Create a referrer and mint a code.
Track a sale against a code.
List issued rewards & payout status.
Define eligibility & reward rules.
Upload voucher pools.
Count a click on a referral link.
Simple, usage-based.
Free for your first 10 referrals. Scale up only when you need to.
Let's talk
Whether you have a question about features, pricing, need a demo, or anything else, our team is ready to answer all your questions.