ReferralRock is a referral marketing platform that helps businesses create and manage referral programs to drive word-of-mouth growth and customer acquisition
ReferralRock is a referral marketing platform that helps businesses create and manage referral programs to drive word-of-mouth growth and customer acquisition On Nagent, ReferralRock is exposed as a fully-configurable marketing automation integration that any agent can call — 33 actions, and BASIC authentication. No code is required to wire ReferralRock into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use ReferralRock to automate the kinds of tasks marketing automation teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire ReferralRock into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against ReferralRock, with input parameters and output schema. Drop these into any step of an agent built in Helix.
REFERRALROCK_DELETE_EMAIL_REMOVEUNSUBSCRIBETool to remove an email address from the unsubscribe list. Use when you need to resubscribe an email address that was previously unsubscribed.
Input parameters
The email address to remove from the unsubscribe list
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_DELETE_HOOKSTool to delete a webhook subscription. Use when you need to cancel and stop data transmission to a registered webhook URL.
Input parameters
The unique ID of the webhook subscription to cancel. Must be a valid GUID format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_DELETE_MEMBERS_REMOVETool 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 (program details) to be uniquely identified.
Input parameters
Collection of member removal requests. Each member requires either valid primaryInfo OR both secondaryInfo and tertiaryInfo to be uniquely identified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_DELETE_REFERRAL_REMOVETool 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.
Input parameters
List of referral queries to remove. Each must be uniquely identifiable.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_DELETE_REWARDS_REMOVETool to delete rewards from members or referrals in a referral program. Use when you need to remove one or more rewards from the system.
Input parameters
List of reward identifiers to remove from the system
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_EMAIL_GETUNSUBSCRIBEDTool to check if an email address is unsubscribed from communications. Use when you need to verify unsubscribe status before sending emails.
Input parameters
Email address to check unsubscribe status for. If not provided, retrieves all unsubscribed emails.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_HOOKS_HISTORY_EVENTNAMETool 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.
Input parameters
The name of the event to retrieve webhook history for (e.g., 'MemberAdd', 'MemberUpdate').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_MEMBERSTool 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.
Input parameters
Sorting column. Default is Create_Dt_Desc (newest first).
Number of members to return. Default returns all available members.
Search query - member must have this value as email, internal ID, external ID, or referral code.
Filter members created on or before this date (ISO 8601 format: YYYY-MM-DD).
Starting index (0-based) for pagination. Default is 0.
Filter members created on or after this date (ISO 8601 format: YYYY-MM-DD).
Program identifier using ID, name, or title to filter members by program.
True displays disabled members; False shows active members only. If not specified, returns both.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_MEMBER_STATS_GET_SINGLETool 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.
Input parameters
Identifier for the member. Can be an email address, member ID, external ID, or referral code.
The time range for which to retrieve statistics. Accepted values are: All (all-time statistics), MonthToDate (statistics from the beginning of the current month), LastMonth (statistics from the previous month), Last7Days (statistics from the last 7 days), Last30Days (statistics from the last 30 days).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_PAYOUTS_IDTool to get payout details by ID. Use when you need to retrieve specific payout information using a payout identifier.
Input parameters
The unique identifier for the payout to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_PAYOUTS_PENDINGTool 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.
Input parameters
The unique ID of the member to whom the amount is owed (deprecated, use recipientId instead).
Unique identifier of the recipient owed the amount.
Includes payouts for ineligible rewards with future eligibility dates. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_PAYOUTS_TRANSACTIONSTool 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.
Input parameters
The unique ID of the payout transaction recipient.
The unique ID of the payout transaction.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_PROGRAM_GETSINGLETool to retrieve a single referral program by name. Use when you need details about a specific program.
Input parameters
Name of the program of interest
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_PROGRAMSList all referral programs in ReferralRock. Use this to retrieve details about available referral programs with pagination support.
Input parameters
Number of programs to return. Default is 30. Maximum depends on API limits.
Starting index (0 based) of the programs to retrieve. Used for pagination.
Identifies a specific program of interest. Use this to filter for a particular program.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_REFERRALSTool 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.
Input parameters
Sort order for the results. Default is Create_Dt_Desc (newest first).
Number of referrals to return per page. Default is all available referrals.
Search term to filter referrals by email, internal ID, external ID, or referral code. If matches internal referral ID, overrides other filters.
Show referrals created on or before this date. Format: ISO8601 date string (e.g., '2023-12-31').
Starting index for pagination (0-based). Default is 0.
Filter referrals by their current status.
Show referrals created on or after this date. Format: ISO8601 date string (e.g., '2023-01-01').
Filter results to show referrals associated with a specific member.
Program identifier (ID, name, or title) to filter referrals by specific program.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_REFERRAL_SINGLETool 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.
Input parameters
The email address of the referral to retrieve.
The external identifier of the referral to retrieve.
The unique identifier of the referral to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_REWARDRULESTool 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.
Input parameters
ID of the program. This is a required parameter that identifies which program's reward rules to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_GET_REWARDSTool 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.
Input parameters
Sort column. Defaults to Create_Dt_Desc if not specified.
Number of reward records to return. Defaults to all records if not specified.
Filter by recipient email, ID, external ID, or member referral code.
Show rewards created before this date (ISO format or date string).
Starting index for pagination (0-based). Defaults to 0.
Filter by reward status. Valid values: Pending, Processing, Issued.
Show rewards created after this date (ISO format or date string).
GUID identifier of the member to filter by.
ID of the program, program name, or program title to filter by.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_EMAIL_REMOVEUNSUBSCRIBETool 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.
Input parameters
The email address to be removed from the unsubscribe list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_EMAIL_UNSUBSCRIBETool to unsubscribe an email address from the ReferralRock mailing list. Use when a user wants to opt out of email communications.
Input parameters
Email address to unsubscribe from the mailing list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_HOOKSTool 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.
Input parameters
Event type to monitor. Valid values: ProgramAdd, MemberAdd, MemberUpdate, MemberDelete, ReferralAdd, ReferralStatusChange, ReferralUpdate, ReferralDelete, RewardAdd, RewardIssue, or EmailUnsubscribed.
The callback URL that receives event notifications via POST requests with JSON data.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_INVITEFEEDTool to create an invite feed entry for automatic invitations. Use when you need to add a contact to the referral program's invite queue.
Input parameters
Contact's email address.
Contact's last name.
Contact's first name.
Optional contact type identifier to declare the API event where the contact originates.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_INVITEFEEDSTool 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.
Input parameters
Array of invite feed entries to create. Each entry must include firstName, lastName, and email (all required), with an optional contactType parameter.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_MEMBER_ACCESS_URLSTool 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.
Input parameters
Internal member ID (36 characters). One of four identifiers required.
External system ID (0-100 characters). One of four identifiers required.
Member's email address (0-100 characters). One of four identifiers required.
Member's referral code (0-50 characters). One of four identifiers required.
Link expiration time in minutes (5-43200). Defaults to 20 minutes if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_MEMBERSTool 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.
Input parameters
City name.
Member's email address.
Contact phone number.
Country name.
Member's surname.
Member account password. If not provided, member will need to reset password on first login.
Member's first name.
Program identifier for membership. This is the GUID of the program to which the member will be added.
Payment configuration object for member rewards.
Postal or ZIP code.
Birth date in ISO format (YYYY-MM-DD).
Primary address line.
Secondary address line (apartment, suite, etc.).
Membership activation status. Set to true to create the member in a disabled state.
Custom referral identifier. If not provided, one will be auto-generated.
Custom text field name for additional member data.
Second custom text field name for additional member data.
Triggers confirmation email; defaults to false. Set to true to send a welcome email to the new member.
Custom text field value for customText1Name.
Second custom text field value for customText2Name.
Custom field name for additional member data.
Branded URL override for the member's referral links.
Associated recruiter ID (GUID). Either this or recruiterAssignedId is conditionally required if the program requires a recruiter.
State or province designation.
Custom field value for customOption1Name.
External system link identifier for integration purposes.
Currently assigned recruiter ID (GUID). Either this or recruiterSourceId is conditionally required if the program requires a recruiter.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_MEMBERS_REMOVETool 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.
Input parameters
Array of member removal information objects. Each object contains a query to identify the member to remove.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_REFERRALACTIONTool 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, or external identifier.
Input parameters
Identifier for the referral action. Optional name to describe the action.
Referral action amount, used for calculating percentage based recurring rewards
Search by program ID, name, or title. Optional parameter to specify the program.
Lookup mechanism using ReferralID, email, or External ID
External ID, used for preventing duplicates and referencing original source. Optional unique identifier from external system.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_REFERRAL_REMOVETool to remove referrals from a referral program. Use when you need to delete referrals using their referral ID or alternative identifiers.
Input parameters
Collection of referral identification queries. Each referral requires either primaryInfo OR both secondaryInfo and tertiaryInfo for unique identification.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_REFERRALSTool 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.
Input parameters
City name.
Internal notes about the referral. Not visible to the referral.
Referral's email address.
Order total or transaction value.
State/province/region.
Referral state. Allowed values: 'pending', 'qualified', 'approved', or 'denied'.
Country name.
Referral's surname.
Referral's given name.
ZIP/postal code.
Publicly visible referral notes.
Business name.
Customer contact number.
Street address line 1.
Street address line 2 (apartment, suite, etc.).
The referral code from the member that introduced the referral. This is required to associate the referral with a specific member.
Custom text 1 field name.
Custom text 2 field name.
Custom text 3 field name.
Custom text 1 field value.
Custom text 2 field value.
Custom text 3 field value.
Contact preference. Allowed values: 'email', 'callMorning', 'callAfternoon', or 'callEvening'.
Custom option 1 field name.
Custom option 2 field name.
Custom option 1 field value.
Custom option 2 field value.
Unique external identifier you can use to later reference the referral.
Currently assigned recruiter identifier (GUID format).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_REFERRALS_STATUSTool 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.
Input parameters
Referral reward amount as a decimal value
New status value for the referral. Must be one of: 'pending', 'qualified', 'approved', or 'denied'
Identifier of the associated program
Customer-facing note about the status update
Identifier for the referral to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_REFERRAL_UPDATETool 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 to identify referrals. Supports bulk updates by providing multiple update items.
Input parameters
List of referral updates to process. Each item contains a query to identify the referral and the fields to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_REWARDS_ISSUETool 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.
Input parameters
A message sent to the reward recipient.
The unique identifier for the reward being issued.
For PayPal, include the email address of the recipient. (Deprecated parameter)
Allows you to override eligibility date rules. Issue rewards with eligibility dates in the future.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
REFERRALROCK_POST_REWARDS_REMOVETool 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.
Input parameters
List of reward identifiers to be removed. Each ID should be a string representing a reward in the referral program.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 70 agents privately built on Nagent that already use ReferralRock.
Build on Nagent
Connect ReferralRock to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find ReferralRock, and click "Connect Now." You'll authenticate with BASIC — Nagent handles credential storage and refresh automatically. Once connected, ReferralRock is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once ReferralRock is connected, you configure its 33 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop ReferralRock steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a ReferralRock event fires, the agent kicks off automatically.
Every ReferralRock action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While ReferralRock ships with 33 pre-built marketing automation actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching ReferralRock together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build ReferralRock-based workflows tailored to your business.