Back to Help Hub
IntegrationsHow-To1 min readUpdated 2026-03-09

Referral Factory API — adding referrers via API

Use the API to programmatically enrol users as referrers in your campaign — for example, automatically adding a customer as a referrer the moment they complete.

Browse topics and support
Navigation

Topics

Article

On this page

Support

Ask AI

Ask a product or setup question without leaving this page.

Need human help?

Still stuck?

If this article does not solve the problem, send the context to support or book time with a human.

We will keep the article or page context with your request so support can respond faster.
Read this page as a quick path: scan the headings, use the step blocks, and escalate if the expected result does not happen.
Use the API to programmatically enrol users as referrers in your campaign — for example, automatically adding a customer as a referrer the moment they complete their first purchase.

Endpoint

Authentication

Include your API Key as a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Find your API Key in Campaign Settings → Integrations and API → API & Webhooks tab, or in the API Integration panel on your campaign dashboard.

Request payload

Minimum required fields:

What happens after the API call

If successful, a new referrer record is created in your campaign and a unique referral link is generated for them. If the welcome email is enabled, it will be sent automatically.
The response includes the new user's referral link and referral code, which you can then store in your own system or pass back to the user within your product.
See the full developer docs at developers.referral-factory.com.
Related strategy reading

Go deeper with Learn

This help article explains the setup. These Learn guides explain the bigger strategy, planning, and real-world use of referral programs.

Article feedback

Did this answer your question?

Your vote helps support spot weak articles, fix missing steps, and decide when a person should step in.