invitation.dev
the referral api
like stripe™, for referrals
Add a referral program to your app — tracking, rewards, payouts, and a network of promoters ready to share it.
# so simple your coding agent implements it in one session
{
"mcpServers": {
"invitation": {
"type": "http",
"url": "https://api3.invitation.codes/api/mcp",
"headers": {
"Authorization": "Bearer invt_..."
}
}
}
}Mint a key with the agent scope at invitation.app/settings/api-keys.
The MCP route is feature-gated: a target environment must enable FEATURE_AGENT_API. This page does not execute the connection or provide a demo account.
Browser tracking is available through the @invitation/tracker package and the hosted script at /api/v3/referral/tracker.js. See the integration notes for browser-only and staging/runtime caveats.
The full engine
Referral links and codes, double-sided rewards, budget caps, approval rules, fraud checks, and payouts. Fund rewards with Invitation coins, or use them alongside your own incentives.
Built-in promoters
An activated campaign can be linked to an invitation.codes program page and made available to the Invitation network. You get referral infrastructure and a distribution surface.
Connect your stack
Verify conversions where they happen: the browser tracker and one server-side SDK call are built; Stripe still needs staging proof, Shopify is coming, and signed webhooks send results back to your app.
Agent-ready by design
Typed clients, OpenAPI, llms.txt, and a remote MCP server give coding agents the same campaign and conversion primitives as human developers. Runtime access remains feature-gated per environment.
# what activation produces
a shareable program, not a fabricated demo
hosted proof pendingCampaign activation is wired to create or link a public directory program. The repository also carries a deterministic local fixture named e2e-program. Neither is presented here as a live public campaign: the hosted seed, deployment, and public URL still need runtime evidence.
01 / draft
Create reward and validation terms.
02 / test
Record a real referral session and no-credit conversion.
03 / activate
Return the console URL and resolved directory URL.
runtime evidence required
- API-key scopes and org binding confirmed
- one browser click creates an attribution session
testMode: truerecords without rewards- the returned invitation.codes URL resolves
This toolkit is an effort by the team behind Invitation: a fast-growing social network that lets people promote brands they love, and reap some rewards in the process. It became a community loved by brands too. Through their referral campaigns, they get to reach new audiences at a fraction of the cost of traditional advertising, and everyone earns rewards in the process.
# join our partners network
We're helping selected companies integrate and promote the Invitation API.
- Agencies
- Platforms
- Merchants