Referral Rock

API Referral Program Integration

Use the Referral Rock REST API to build custom integrations, sync data with any platform, and automate referral workflows programmatically.

About Our REST API Referral Integration

REST API logo

REST API

API / Webhook

Use the Referral Rock REST API to build custom integrations, sync data with any platform, and automate referral workflows programmatically.

What it does
Share | Track | Enrich | Payout
Category
Other
Documentation
View Setup Guide
Plans
Available with all Referral Rock plans
Data Privacy
When using this integration, it's up to you to comply with applicable laws and regulations, as well as Referral Rock's Terms of Service and Privacy Policy.

Referral Rock provides a powerful API so you can connect your existing software and tools directly to your Referral Rock account.

How the REST API Integration Works

1

Authenticate with your API key

Generate a Referral Rock API key from your account settings and add it to your app or backend. Takes minutes to get started.

2

Add and sync advocates

Use the Members API to register advocates directly from your app or portal. Existing users can be enrolled without a separate referral program signup.

3

Post referral conversions

Call the Referrals API to record conversions from your checkout, CRM, or any system that confirms a sale or sign-up.

4

Trigger rewards via API

Push referral status updates to Referral Rock and rewards issue automatically. Gift cards, cash, or custom incentives based on your program rules.

Access a list of your referrals to add to your CRM

Get your entire list of referrals, which can be sorted by create date or filtered by the specific referral program.

Add new advocates to your program

New members are automatically created and added to your referral program.

Trigger rewards based on changes

Fully automate your referral program from start to finish, without interrupting your sales team. Referral Rock will issue rewards based on any referral status updates.

Get key performance data from any Member

Access all data about a member's sharing, referral, and reward activities.

Create a custom advocate experience in your app or customer portal

Customize a unique sharing experience or securely embed our Member Portal or Share Widget directly into your platform.

REST API Referral Integration — FAQ

The REST API uses Basic Authentication over HTTPS. You generate a public and private API key in your Referral Rock account, Base64-encode the publicKey:privateKey pair, and pass it in the Authorization header of each request. Full authentication details, endpoints, and sample calls are in the REST API reference.
The API lets you register and sync advocates (Members), record referrals and conversions, read sharing, referral, and reward data for any Member, and trigger reward logic, all programmatically. You can also power a fully custom advocate experience or securely embed the Member Portal and Share Widget in your own app.
Yes. Unlike our no-code integrations, the API is built for developers. It's a standard REST API using HTTPS and JSON, so any engineering team can work with it, but implementation is a development task rather than a point-and-click setup. Our team can advise on the right endpoints and approach for your use case.
Yes. The API enforces rate limiting to keep the platform stable for everyone. The current limits and how to handle them are documented in the REST API reference.
The complete REST API reference, including authentication, every endpoint, request and response formats, and sample calls, is available at api.referralrock.com. Every Referral Rock plan also includes onboarding support if you'd like guidance scoping your integration.
“Their integrations, their obsession to be on the leading edge of their niche, the overall customizability... All in all, I saved thousands by not needing to build an app or sign up for a long-term contract.”

Need help setting up?

Every Referral Rock plan includes dedicated onboarding support. Our team will help you configure the REST API integration and make sure everything is working perfectly. View the setup guide →

Ready to Connect REST API?

Start your free trial and set up the integration in minutes. No credit card required.