ReferralRock
ReferralRock is a referral marketing platform that helps businesses create and manage referral programs to drive word-of-mouth growth and customer acquisition
Verdict
Common use cases
- Enroll beta users in referral programs
- Log referrals during customer onboarding calls
- Bulk import invite lists from spreadsheets
- Track recurring reward actions for subscriptions
- Set up event webhooks for Slack alerts
Integration
- Vendor
- ReferralRock
- Category
- other
- Auth
- OAUTH2
- Tools
- 35
- Composio slug
referralrock
Tools
- Add new member to program
Tool to create a new member and add them to a referral program. Use when you need to add a new member with their program ID, name, and email. Returns HTTP 201 (Created) on success with member confirmation details.
- Create Invite Feed Entries
Tool to create multiple invite feed entries for automatic invites in ReferralRock. Use when you need to send a set of contacts to be used with automatic member invitations.
- Create Invite Feed Entry
Tool to create an invite feed entry for automatic invitations. Use when you need to add a contact to the referral program's invite queue.
- Create New Referral
Tool to create a new referral in ReferralRock based on a member's referral code. Use when you need to add a referral to a program, providing details like contact information, transaction amount, and custom fields.
- Create Referral Action
Tool to create a referral action for processing recurring rewards. Use when you need to record a referral action with an amount value for calculating percentage-based recurring rewards. The action can be linked to referrals via email, ID, o
- Create Webhook Subscription
Tool to create or update a webhook subscription for event notifications. Use when you need to register a callback URL to receive POST requests with JSON data when specified events occur.
- Delete Members from Programdestructive
Tool to delete members from a referral program. Use when you need to remove one or more members. Each member requires either valid primaryInfo (memberId or referralCode) OR both secondaryInfo (externalIdentifier or email) and tertiaryInfo (
- Delete Referraldestructive
Tool to delete one or more referrals from a referral program. Use when you need to remove referrals by their unique ID or other identifying information. Each referral is deleted only when it can be uniquely identified.
- Delete Rewardsdestructive
Tool to delete rewards from members or referrals in a referral program. Use when you need to remove one or more rewards from the system.
- Delete Webhookdestructive
Tool to delete a webhook subscription. Use when you need to cancel and stop data transmission to a registered webhook URL.
- Generate Member Access Token
Tool to generate pre-authenticated member access URLs for sharing and portal experiences. Use when you need to create temporary access tokens for members to access their portal or share content. Note: This endpoint is deprecated; consider u
- Generate Member Access URLs
Tool to generate member access URLs for custom share experience or secure portal embedding. Use when you need to create unique access and share links for members with optional expiration time.
- Get Email Unsubscribed Status
Tool to check if an email address is unsubscribed from communications. Use when you need to verify unsubscribe status before sending emails.
- Get Member Statistics
Tool to retrieve comprehensive statistics for a single member from ReferralRock. Use when you need to analyze a member's sharing, referral, and reward activities over a specified time period.
- Get Payout
Tool to retrieve payout list by ID. Use when you need to get specific payout information using a payout identifier.
- Get Payout Details by ID
Tool to get payout details by ID. Use when you need to retrieve specific payout information using a payout identifier.
- Get Payout Transactions
Tool to get payout transaction history for referral program participants. Use when you need to retrieve payout transaction information, optionally filtering by recipient ID or specific transaction ID.
- Get Pending Payouts
Tool to get pending payouts for a member or recipient. Use when you need to retrieve pending payout information, optionally filtering by recipient and including ineligible rewards.
- Get Referrals
Tool to list referrals with filtering and pagination options. Use when you need to retrieve referrals from ReferralRock, optionally filtered by program, member, date range, status, or search query. Supports sorting and pagination.
- Get Reward Rules
Tool to get reward rules for a program. Use when you need to retrieve member rewards rules configuration including triggers, payouts, and delivery settings for a specific program.
- Get Rewards
Tool to list rewards with optional filtering and pagination. Use when you need to retrieve rewards filtered by program, member, status, date ranges, or specific search queries. Supports sorting and pagination via offset/count parameters.
- Get Single Program
Tool to retrieve a single referral program by name. Use when you need details about a specific program.
- Get Single Referral
Tool to retrieve a single referral by email, ID, or external ID. Use when you need to fetch detailed information about a specific referral from ReferralRock.
- Get Webhook History for Event
Tool to retrieve webhook history for a specific event. Use when you need to check the delivery status and details of webhooks for a particular event type.
- Issue Reward to Member
Tool to issue a reward to a member in the Referral Rock system. Use when you need to issue a specific reward to a recipient, with the option to override eligibility date rules.
- List Program Members
Tool to list program members with filtering and pagination. Use when you need to retrieve member information, optionally filtering by program, search query, status, or date range. Supports sorting and pagination for large datasets.
- List Referral Programs
List all referral programs in ReferralRock. Use this to retrieve details about available referral programs with pagination support.
- Remove Email from Unsubscribe Listdestructive
Tool to remove an email address from the unsubscribe list. Use when you need to resubscribe a previously unsubscribed email address to allow them to receive emails again.
- Remove Email from Unsubscribe Listdestructive
Tool to remove an email address from the unsubscribe list. Use when you need to resubscribe an email address that was previously unsubscribed.
- Remove Members from Programdestructive
Tool to remove members from a referral program. Use when you need to delete members from the system. A member is removed when uniquely identified by either primaryInfo (memberId or referralCode) OR both secondaryInfo and tertiaryInfo.
- Remove Referraldestructive
Tool to remove referrals from a referral program. Use when you need to delete referrals using their referral ID or alternative identifiers.
- Remove Rewardsdestructive
Tool to remove rewards from members or referrals of a referral program. Use when you need to delete one or more rewards by their IDs. The endpoint returns a result for each reward ID indicating whether the removal was successful.
- Unsubscribe Email Address
Tool to unsubscribe an email address from the ReferralRock mailing list. Use when a user wants to opt out of email communications.
- Update Referral Details
Tool to update referral details in a referral program. Use when you need to modify existing referral information such as contact details, status, notes, or custom fields. Requires either a referralId OR both secondaryInfo and tertiaryInfo t
- Update Referral Status
Tool to update referral status in ReferralRock. Use when you need to change a referral's status to pending, qualified, approved, or denied. Note: This endpoint is deprecated; use POST /api/referral/update instead.
Setup
Setup guide
- 11. In your Switchy workspace settings, navigate to Integrations and select ReferralRock from the MCP directory. 2. Click Connect and you'll be redirected to ReferralRock's OAuth consent screen. 3. Grant access to read and write members, referrals, and webhook subscriptions — these scopes let the MCP create members, log referrals, and subscribe to program events. 4. After authorizing, you'll return to Switchy with a green confirmation banner. 5. Open any Space and type '@ReferralRock list programs' to verify the connection — you should see your active referral programs. 6. To test member creation, try '@ReferralRock add a new member to program [program_id] with email test@example.com and name Test User' and check your ReferralRock dashboard for the new entry. 7. If the connection fails, confirm your ReferralRock account has API access enabled in account settings.
What teammates see: by default, memories from ReferralRock are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Add Launch Day Members
@ReferralRock add these five members to program ABC123: alice@startup.com (Alice Chen), bob@agency.co (Bob Martinez), carol@saas.io (Carol Kim), dan@tech.com (Dan Okafor), eve@design.studio (Eve Patel). Use their email as the external ID.Open in a Space →
Log Support Referral
@ReferralRock create a referral in program ABC123 using referral code ALICE2024. The referred contact is frank@example.com (Frank Liu), transaction amount $99, and the referral happened today.Open in a Space →
Queue Invite Batch
@ReferralRock create invite feed entries for program ABC123 with these contacts: grace@corp.com (Grace Thompson), henry@startup.io (Henry Zhao), iris@agency.net (Iris Novak). Set them to send invites starting tomorrow.Open in a Space →
Track Subscription Action
@ReferralRock create a referral action for referral ID ref_67890 with amount $149. This is for the monthly renewal that just processed and should calculate the 10% recurring reward.Open in a Space →
Set Up Slack Webhook
@ReferralRock create a webhook subscription for program ABC123 that posts to https://hooks.slack.com/services/YOUR/WEBHOOK/URL whenever a referral is created or a reward is earned.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@ReferralRock show me all members who joined our referral program in the last 30 days and how many referrals each has generated
Based on your ReferralRock program data, 47 members joined in the last 30 days. Top performers: Sarah Chen (12 referrals, $2,400 in attributed revenue), Marcus Williams (8 referrals, $1,600), and Priya Patel (7 referrals, $1,050). 23 members have generated 1-3 referrals each, while 18 members haven't yet generated their first referral. Average referrals per new member: 2.3. This data reflects your program's current state as of this query.
This example demonstrates read-heavy analytics across member and referral data. Requires OAuth2 scope for reading member lists and referral records. ReferralRock's API returns paginated results, so large programs may need multiple calls. Response times vary with program size.
@ReferralRock create a new member for jessica.martinez@example.com in our Partner Program and send her an automatic invite
Member created successfully. Jessica Martinez has been added to your Partner Program with member ID #RM-8472 and assigned referral code JMART24. An invite feed entry was created to trigger your automatic invitation workflow—Jessica should receive her personalized referral link via email within the next few minutes, depending on your program's invite cadence settings. Her member dashboard is now active and ready to track referrals.
This write example shows member creation paired with invite automation. Requires OAuth2 write scope for both members and invite feeds. Side-effect: Jessica receives an email invitation immediately. If your program has custom onboarding workflows or approval gates, those will execute before the invite sends.
@ReferralRock draft a summary email for our top 10 referrers this month, highlighting their performance and suggesting they share their link on social media
Subject: You're crushing it—here's your January impact! Hi [Name], you're in our top 10 referrers this month with [X] successful referrals worth $[Y]. That's [Z]% more than last month! Your unique link has been clicked [N] times, showing strong interest from your network. Quick win: Share your referral link on LinkedIn or Twitter this week. Our data shows social shares convert 2.3x better than email forwards. Need graphics? Grab our ready-made posts in your dashboard under 'Marketing Assets.' Keep up the momentum—you're making a real difference!
This synthesis example combines ReferralRock member data with AI copywriting to personalize outreach at scale. The AI can tailor tone and CTAs based on each referrer's performance metrics. You'll need to fetch member stats first, then iterate the template. Useful for monthly recognition campaigns or re-engagement nudges.
Use-case deep-dives
When ReferralRock fits early-stage SaaS growth teams
A 6-person SaaS startup running a customer referral program during onboarding hits the sweet spot for this MCP. Your support or growth lead can add new members to the program as signups convert, create referrals when existing customers share invite links, and track recurring reward actions without leaving the AI workspace. The OAuth2 flow means one-time setup per team member. The 35 tools cover the full lifecycle—member creation, invite feed management, referral deletion when deals fall through. This works when your referral volume is under 200 new members per month and you're not running complex multi-tier reward logic. If your program has conditional payouts based on customer LTV tiers or requires custom fraud detection, you'll need ReferralRock's native dashboard. For straightforward invite-and-reward programs where the growth team wants quick member lookups and referral creation during customer calls, this MCP removes the context-switch tax.
Managing multiple referral programs for agency clients
A 4-person marketing agency managing referral programs for 8-12 clients can use this MCP to centralize program admin without juggling browser tabs. Each client gets their own ReferralRock program; the agency team uses Switchy to add members, create referrals, and pull reports across all programs in one workspace. The webhook subscription tool lets you pipe program events into your agency's Slack or project tracker. This setup saves 30-45 minutes per week when you're fielding client questions like "did Sarah's referral convert?" or "add these five contacts to the invite queue." The boundary: if clients demand real-time dashboards or white-labeled reporting, you're still handing them ReferralRock logins. But for day-to-day ops—bulk member imports, referral creation during client check-ins, quick member deletions—the MCP keeps your team in one tool instead of eight ReferralRock accounts.
Bulk referral hygiene for seasonal e-commerce brands
A 3-person e-commerce brand running a seasonal affiliate program (think holiday gift boxes or back-to-school gear) needs this MCP for post-campaign cleanup. After a 6-week promo push, you've got 400 new members, 150 referrals that didn't convert, and duplicate entries from your Shopify import. The delete members and delete referral tools let your ops person batch-remove invalid entries during a 20-minute standup review instead of clicking through ReferralRock's UI. The create referral action tool handles recurring rewards if you're paying affiliates monthly commissions on subscription boxes. This works when your program is under 1,000 active members and you run 2-3 campaigns per year. If you're processing 500+ referrals per week year-round, the API rate limits and manual batch operations get tedious—you'd want a dedicated integration engineer. For seasonal spikes and quarterly hygiene sweeps, the MCP keeps your small team moving without hiring a referral ops specialist.
Frequently asked
What does the ReferralRock MCP let me do in Switchy?
It connects your ReferralRock referral program to Switchy's AI workspace so you can add members, create referrals, track rewards, and manage invite feeds without leaving the chat. You can ask the AI to enroll a customer, record a referral action for recurring rewards, or pull program stats — all through natural language instead of logging into ReferralRock's dashboard.
Do I need admin access to connect ReferralRock via OAuth?
Yes. OAuth setup requires a ReferralRock account with API access, which typically means admin or owner permissions. During the flow you'll authorize Switchy to read and write members, referrals, and webhooks on your behalf. If you're not an admin, ask whoever manages your ReferralRock account to complete the connection in Switchy.
Can the MCP automatically send referral invites to my email list?
Not directly. The MCP can create invite feed entries — contacts queued for ReferralRock's automatic invitation system — but it doesn't send emails itself. You still configure invite templates and sending rules inside ReferralRock. Think of the MCP as a way to bulk-add contacts to the queue, not a replacement for ReferralRock's email engine.
Why use this MCP instead of ReferralRock's dashboard or API?
The MCP saves you from context-switching when you're already working in Switchy. Instead of opening ReferralRock to add a member or check a referral, you ask the AI and it calls the API for you. It's faster for one-off tasks and lets non-technical teammates interact with referral data without learning ReferralRock's interface or writing code.
Who on my team should connect the ReferralRock MCP?
Whoever runs your referral program — usually marketing ops or growth. They'll need ReferralRock admin rights to authorize OAuth. Once connected, you can share the Switchy workspace with customer success or sales reps who need to enroll members or log referrals but don't need full ReferralRock access. Each action still respects your ReferralRock permissions.