Stays with you
- The moments that trigger an invitation
- The offer and the advantage, and who qualifies
- Billing, credits and your loyalty rules
- Your customer data, in your own system
Your system knows the good moments: a renewal, a milestone. One API call turns each of them into a video recommendation, with an offer for the friend and an advantage for your customer.



The situation
Take a language-learning app, sold by subscription. Its members talk about it at dinner. The programme gives them a code to copy, and few do. What is missing is a reason to share today, and something worth sending.
subscription.renewed
She just chose to stay. A good day to ask who else should join.
milestone.reached
The app congratulates her. The invitation arrives in the same breath.
plan.upgraded
She is already thinking about other people.
The events are your own. You choose which ones call Referral.
01 · Trigger · REST API
When a renewal goes through, your back end tells Referral who the customer is and which campaign applies. Léa gets an email with her personal link.
POST /referral/invitations
{
"campaign": "renewal",
"customer": {
"first_name": "Léa",
"email": "lea@example.com"
}
}
→ 201 · personal link sent by email
Your friend gets a free month. So do you.
02 · Record · Share
Léa opens her link and records in the browser. She can make one video for everyone, or a different one for each friend. Tom gets his own.




03 · Offer · Activation
The page is in your colours. Tom watches, reads the offer, and starts his subscription. You choose how the offer reaches him.
A signed redirect sends Tom to your site. The offer is applied there, and you know which recommendation he came from.
Upload a pool of codes. Each friend receives one, to enter in the app or at checkout. For example: TEMPO-R8KD.



04 · Reward · Measure
Signed webhooks tell your system when a link is opened, when an offer is issued and when a new subscription is confirmed. Your billing then gives Léa her free month.


She was going to tell him anyway. Now it comes with your offer.
What the team gets
Stays with you
Referral takes care of

She reads the campaign statistics. He has the developer role, the keys and the webhooks.
Other use cases