ReferralRock
referralrockReferralRock is a referral marketing platform that helps businesses create and manage referral programs to drive word-of-mouth growth and customer acquisition
Acciones disponibles (35)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Remove Email from Unsubscribe ListREFERRALROCK_DELETE_EMAIL_REMOVEUNSUBSCRIBEAcciónTool to remove an email address from the unsubscribe list. Use when you need to resubscribe an email address that was previously unsubscribed.
REFERRALROCK_DELETE_EMAIL_REMOVEUNSUBSCRIBEAcciónTool to remove an email address from the unsubscribe list. Use when you need to resubscribe an email address that was previously unsubscribed.
Parámetros de entrada
emailstringObligatorioThe email address to remove from the unsubscribe list
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete WebhookREFERRALROCK_DELETE_HOOKSAcciónTool to delete a webhook subscription. Use when you need to cancel and stop data transmission to a registered webhook URL.
REFERRALROCK_DELETE_HOOKSAcciónTool to delete a webhook subscription. Use when you need to cancel and stop data transmission to a registered webhook URL.
Parámetros de entrada
web_hook_idstringObligatorioThe unique ID of the webhook subscription to cancel. Must be a valid GUID format.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete Members from ProgramREFERRALROCK_DELETE_MEMBERS_REMOVEAcciónTool 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.
REFERRALROCK_DELETE_MEMBERS_REMOVEAcciónTool 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.
Parámetros de entrada
membersobject[]ObligatorioCollection of member removal requests. Each member requires either valid primaryInfo OR both secondaryInfo and tertiaryInfo to be uniquely identified.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete ReferralREFERRALROCK_DELETE_REFERRAL_REMOVEAcciónTool 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.
REFERRALROCK_DELETE_REFERRAL_REMOVEAcciónTool 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.
Parámetros de entrada
referralsobject[]ObligatorioList of referral queries to remove. Each must be uniquely identifiable.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete RewardsREFERRALROCK_DELETE_REWARDS_REMOVEAcciónTool to delete rewards from members or referrals in a referral program. Use when you need to remove one or more rewards from the system.
REFERRALROCK_DELETE_REWARDS_REMOVEAcciónTool to delete rewards from members or referrals in a referral program. Use when you need to remove one or more rewards from the system.
Parámetros de entrada
reward_idsstring[]ObligatorioList of reward identifiers to remove from the system
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Email Unsubscribed StatusREFERRALROCK_GET_EMAIL_GETUNSUBSCRIBEDAcciónTool to check if an email address is unsubscribed from communications. Use when you need to verify unsubscribe status before sending emails.
REFERRALROCK_GET_EMAIL_GETUNSUBSCRIBEDAcciónTool to check if an email address is unsubscribed from communications. Use when you need to verify unsubscribe status before sending emails.
Parámetros de entrada
emailstringEmail address to check unsubscribe status for. If not provided, retrieves all unsubscribed emails.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Webhook History for EventREFERRALROCK_GET_HOOKS_HISTORY_EVENTNAMEAcciónTool 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.
REFERRALROCK_GET_HOOKS_HISTORY_EVENTNAMEAcciónTool 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.
Parámetros de entrada
event_namestringObligatorioThe name of the event to retrieve webhook history for (e.g., 'MemberAdd', 'MemberUpdate').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Program MembersREFERRALROCK_GET_MEMBERSAcciónTool 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.
REFERRALROCK_GET_MEMBERSAcciónTool 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.
Parámetros de entrada
sortstringenumSorting column. Default is Create_Dt_Desc (newest first).
Create_Dt_AscCreate_Dt_DescMember_Views_AscMember_Views_DescPage_Views_AscPage_Views_DescLead_Count_AscLead_Count_DescReward_Issued_Total_AscReward_Issued_Total_DescMember_Full_Name_AscMember_Full_Name_DesccountintegerNumber of members to return. Default returns all available members.
querystringSearch query - member must have this value as email, internal ID, external ID, or referral code.
dateTostringFilter members created on or before this date (ISO 8601 format: YYYY-MM-DD).
offsetintegerStarting index (0-based) for pagination. Default is 0.
dateFromstringFilter members created on or after this date (ISO 8601 format: YYYY-MM-DD).
programIdstringProgram identifier using ID, name, or title to filter members by program.
showDisabledbooleanTrue displays disabled members; False shows active members only. If not specified, returns both.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Member StatisticsREFERRALROCK_GET_MEMBER_STATS_GET_SINGLEAcciónTool 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.
REFERRALROCK_GET_MEMBER_STATS_GET_SINGLEAcciónTool 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.
Parámetros de entrada
querystringObligatorioIdentifier for the member. Can be an email address, member ID, external ID, or referral code.
timePeriodstringObligatorioenumThe 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).
AllMonthToDateLastMonthLast7DaysLast30Days
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get PayoutREFERRALROCK_GET_PAYOUTAcciónTool to retrieve payout list by ID. Use when you need to get specific payout information using a payout identifier.
REFERRALROCK_GET_PAYOUTAcciónTool to retrieve payout list by ID. Use when you need to get specific payout information using a payout identifier.
Parámetros de entrada
idstringObligatorioThe unique identifier for the payout to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Payout Details by IDREFERRALROCK_GET_PAYOUTS_IDAcciónTool to get payout details by ID. Use when you need to retrieve specific payout information using a payout identifier.
REFERRALROCK_GET_PAYOUTS_IDAcciónTool to get payout details by ID. Use when you need to retrieve specific payout information using a payout identifier.
Parámetros de entrada
idstringObligatorioThe unique identifier for the payout to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Pending PayoutsREFERRALROCK_GET_PAYOUTS_PENDINGAcciónTool 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.
REFERRALROCK_GET_PAYOUTS_PENDINGAcciónTool 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.
Parámetros de entrada
memberIdstringThe unique ID of the member to whom the amount is owed (deprecated, use recipientId instead).
recipientIdstringUnique identifier of the recipient owed the amount.
includeIneligiblebooleanIncludes payouts for ineligible rewards with future eligibility dates. Defaults to False.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Payout TransactionsREFERRALROCK_GET_PAYOUTS_TRANSACTIONSAcciónTool 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.
REFERRALROCK_GET_PAYOUTS_TRANSACTIONSAcciónTool 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.
Parámetros de entrada
recipientIdstringThe unique ID of the payout transaction recipient.
transactionIdstringThe unique ID of the payout transaction.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Single ProgramREFERRALROCK_GET_PROGRAM_GETSINGLEAcciónTool to retrieve a single referral program by name. Use when you need details about a specific program.
REFERRALROCK_GET_PROGRAM_GETSINGLEAcciónTool to retrieve a single referral program by name. Use when you need details about a specific program.
Parámetros de entrada
programNamestringObligatorioName of the program of interest
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Referral ProgramsREFERRALROCK_GET_PROGRAMSAcciónList all referral programs in ReferralRock. Use this to retrieve details about available referral programs with pagination support.
REFERRALROCK_GET_PROGRAMSAcciónList all referral programs in ReferralRock. Use this to retrieve details about available referral programs with pagination support.
Parámetros de entrada
countintegerNumber of programs to return. Default is 30. Maximum depends on API limits.
offsetintegerStarting index (0 based) of the programs to retrieve. Used for pagination.
programIdstringIdentifies a specific program of interest. Use this to filter for a particular program.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get ReferralsREFERRALROCK_GET_REFERRALSAcciónTool 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.
REFERRALROCK_GET_REFERRALSAcciónTool 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.
Parámetros de entrada
sortstringenumSort order for the results. Default is Create_Dt_Desc (newest first).
Create_Dt_DescCreate_Dt_AscAmount_DescAmount_AscQualified_Dt_DescQualified_Dt_AscClosed_Dt_DescClosed_Dt_AsccountintegerNumber of referrals to return per page. Default is all available referrals.
querystringSearch term to filter referrals by email, internal ID, external ID, or referral code. If matches internal referral ID, overrides other filters.
dateTostringShow referrals created on or before this date. Format: ISO8601 date string (e.g., '2023-12-31').
offsetintegerStarting index for pagination (0-based). Default is 0.
statusstringenumFilter referrals by their current status.
pendingqualifiedapproveddenieddateFromstringShow referrals created on or after this date. Format: ISO8601 date string (e.g., '2023-01-01').
memberIdstringFilter results to show referrals associated with a specific member.
programIdstringProgram identifier (ID, name, or title) to filter referrals by specific program.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Single ReferralREFERRALROCK_GET_REFERRAL_SINGLEAcciónTool 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.
REFERRALROCK_GET_REFERRAL_SINGLEAcciónTool 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.
Parámetros de entrada
emailstringThe email address of the referral to retrieve.
externalIdstringThe external identifier of the referral to retrieve.
referralIdstringThe unique identifier of the referral to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Reward RulesREFERRALROCK_GET_REWARDRULESAcciónTool 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.
REFERRALROCK_GET_REWARDRULESAcciónTool 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.
Parámetros de entrada
programIdstringObligatorioID of the program. This is a required parameter that identifies which program's reward rules to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get RewardsREFERRALROCK_GET_REWARDSAcciónTool 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.
REFERRALROCK_GET_REWARDSAcciónTool 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.
Parámetros de entrada
sortstringSort column. Defaults to Create_Dt_Desc if not specified.
countintegerNumber of reward records to return. Defaults to all records if not specified.
querystringFilter by recipient email, ID, external ID, or member referral code.
dateTostringShow rewards created before this date (ISO format or date string).
offsetintegerStarting index for pagination (0-based). Defaults to 0.
statusstringFilter by reward status. Valid values: Pending, Processing, Issued.
dateFromstringShow rewards created after this date (ISO format or date string).
memberIdstringGUID identifier of the member to filter by.
programIdstringID of the program, program name, or program title to filter by.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove Email from Unsubscribe ListREFERRALROCK_POST_EMAIL_REMOVEUNSUBSCRIBEAcciónTool 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.
REFERRALROCK_POST_EMAIL_REMOVEUNSUBSCRIBEAcciónTool 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.
Parámetros de entrada
emailstringObligatorioThe email address to be removed from the unsubscribe list.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Unsubscribe Email AddressREFERRALROCK_POST_EMAIL_UNSUBSCRIBEAcciónTool to unsubscribe an email address from the ReferralRock mailing list. Use when a user wants to opt out of email communications.
REFERRALROCK_POST_EMAIL_UNSUBSCRIBEAcciónTool to unsubscribe an email address from the ReferralRock mailing list. Use when a user wants to opt out of email communications.
Parámetros de entrada
emailstringObligatorioEmail address to unsubscribe from the mailing list.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create Webhook SubscriptionREFERRALROCK_POST_HOOKSAcciónTool 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.
REFERRALROCK_POST_HOOKSAcciónTool 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.
Parámetros de entrada
eventstringObligatorioenumEvent type to monitor. Valid values: ProgramAdd, MemberAdd, MemberUpdate, MemberDelete, ReferralAdd, ReferralStatusChange, ReferralUpdate, ReferralDelete, RewardAdd, RewardIssue, or EmailUnsubscribed.
ProgramAddMemberAddMemberUpdateMemberDeleteReferralAddReferralStatusChangeReferralUpdateReferralDeleteRewardAddRewardIssueEmailUnsubscribedtarget_urlstringObligatorioThe callback URL that receives event notifications via POST requests with JSON data.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create Invite Feed EntryREFERRALROCK_POST_INVITEFEEDAcciónTool to create an invite feed entry for automatic invitations. Use when you need to add a contact to the referral program's invite queue.
REFERRALROCK_POST_INVITEFEEDAcciónTool to create an invite feed entry for automatic invitations. Use when you need to add a contact to the referral program's invite queue.
Parámetros de entrada
emailstringObligatorioContact's email address.
lastNamestringObligatorioContact's last name.
firstNamestringObligatorioContact's first name.
contactTypestringOptional contact type identifier to declare the API event where the contact originates.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create Invite Feed EntriesREFERRALROCK_POST_INVITEFEEDSAcciónTool 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.
REFERRALROCK_POST_INVITEFEEDSAcciónTool 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.
Parámetros de entrada
inviteFeedsobject[]ObligatorioArray of invite feed entries to create. Each entry must include firstName, lastName, and email (all required), with an optional contactType parameter.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Generate Member Access TokenREFERRALROCK_POST_MEMBERACCESSAcciónTool 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 using memberaccessurls endpoint instead.
REFERRALROCK_POST_MEMBERACCESSAcciónTool 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 using memberaccessurls endpoint instead.
Parámetros de entrada
memberQuerystringObligatorioMember Query. Check by Member Id, referral code, email address or External Id.
expireInMinutesintegerNumber of minutes for the expiration of the member access URLs. Default 20 minutes if not specified.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Generate Member Access URLsREFERRALROCK_POST_MEMBER_ACCESS_URLSAcciónTool 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.
REFERRALROCK_POST_MEMBER_ACCESS_URLSAcciónTool 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.
Parámetros de entrada
memberIdstringInternal member ID (36 characters). One of four identifiers required.
externalIdstringExternal system ID (0-100 characters). One of four identifiers required.
emailAddressstringMember's email address (0-100 characters). One of four identifiers required.
referralCodestringMember's referral code (0-50 characters). One of four identifiers required.
expireInMinutesintegerLink expiration time in minutes (5-43200). Defaults to 20 minutes if not specified.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add new member to programREFERRALROCK_POST_MEMBERSAcciónTool 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.
REFERRALROCK_POST_MEMBERSAcciónTool 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.
Parámetros de entrada
citystringCity name.
emailstringObligatorioMember's email address.
phonestringContact phone number.
countrystringCountry name.
lastNamestringMember's surname.
passwordstringMember account password. If not provided, member will need to reset password on first login.
firstNamestringObligatorioMember's first name.
programIdstringObligatorioProgram identifier for membership. This is the GUID of the program to which the member will be added.
payoutInfoobjectPayment configuration object for member rewards.
postalCodestringPostal or ZIP code.
dateOfBirthstringBirth date in ISO format (YYYY-MM-DD).
addressLine1stringPrimary address line.
addressLine2stringSecondary address line (apartment, suite, etc.).
disabledFlagbooleanMembership activation status. Set to true to create the member in a disabled state.
referralCodestringCustom referral identifier. If not provided, one will be auto-generated.
customText1NamestringCustom text field name for additional member data.
customText2NamestringSecond custom text field name for additional member data.
shouldSendEmailbooleanTriggers confirmation email; defaults to false. Set to true to send a welcome email to the new member.
customText1ValuestringCustom text field value for customText1Name.
customText2ValuestringSecond custom text field value for customText2Name.
customOption1NamestringCustom field name for additional member data.
customOverrideURLstringBranded URL override for the member's referral links.
recruiterSourceIdstringAssociated recruiter ID (GUID). Either this or recruiterAssignedId is conditionally required if the program requires a recruiter.
countrySubdivisionstringState or province designation.
customOption1ValuestringCustom field value for customOption1Name.
externalIdentifierstringExternal system link identifier for integration purposes.
recruiterAssignedIdstringCurrently assigned recruiter ID (GUID). Either this or recruiterSourceId is conditionally required if the program requires a recruiter.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove Members from ProgramREFERRALROCK_POST_MEMBERS_REMOVEAcciónTool 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.
REFERRALROCK_POST_MEMBERS_REMOVEAcciónTool 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.
Parámetros de entrada
membersobject[]ObligatorioArray of member removal information objects. Each object contains a query to identify the member to remove.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create Referral ActionREFERRALROCK_POST_REFERRALACTIONAcciónTool 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.
REFERRALROCK_POST_REFERRALACTIONAcciónTool 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.
Parámetros de entrada
namestringIdentifier for the referral action. Optional name to describe the action.
amountnumberObligatorioReferral action amount, used for calculating percentage based recurring rewards
programQuerystringSearch by program ID, name, or title. Optional parameter to specify the program.
referralQuerystringObligatorioLookup mechanism using ReferralID, email, or External ID
externalIdentifierstringExternal ID, used for preventing duplicates and referencing original source. Optional unique identifier from external system.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove ReferralREFERRALROCK_POST_REFERRAL_REMOVEAcciónTool to remove referrals from a referral program. Use when you need to delete referrals using their referral ID or alternative identifiers.
REFERRALROCK_POST_REFERRAL_REMOVEAcciónTool to remove referrals from a referral program. Use when you need to delete referrals using their referral ID or alternative identifiers.
Parámetros de entrada
referralsobject[]ObligatorioCollection of referral identification queries. Each referral requires either primaryInfo OR both secondaryInfo and tertiaryInfo for unique identification.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create New ReferralREFERRALROCK_POST_REFERRALSAcciónTool 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.
REFERRALROCK_POST_REFERRALSAcciónTool 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.
Parámetros de entrada
citystringCity name.
notestringInternal notes about the referral. Not visible to the referral.
emailstringReferral's email address.
amountanyOrder total or transaction value.
regionstringState/province/region.
statusstringenumReferral state. Allowed values: 'pending', 'qualified', 'approved', or 'denied'.
pendingqualifiedapproveddeniedcountrystringCountry name.
lastNamestringReferral's surname.
firstNamestringReferral's given name.
postalCodestringZIP/postal code.
publicNotestringPublicly visible referral notes.
companyNamestringBusiness name.
phoneNumberstringCustomer contact number.
addressLine1stringStreet address line 1.
addressLine2stringStreet address line 2 (apartment, suite, etc.).
referralCodestringObligatorioThe referral code from the member that introduced the referral. This is required to associate the referral with a specific member.
customText1NamestringCustom text 1 field name.
customText2NamestringCustom text 2 field name.
customText3NamestringCustom text 3 field name.
customText1ValuestringCustom text 1 field value.
customText2ValuestringCustom text 2 field value.
customText3ValuestringCustom text 3 field value.
preferredContactstringenumContact preference. Allowed values: 'email', 'callMorning', 'callAfternoon', or 'callEvening'.
emailcallMorningcallAfternooncallEveningcustomOption1NamestringCustom option 1 field name.
customOption2NamestringCustom option 2 field name.
customOption1ValuestringCustom option 1 field value.
customOption2ValuestringCustom option 2 field value.
externalIdentifierstringUnique external identifier you can use to later reference the referral.
recruiterAssignedIdstringuuidCurrently assigned recruiter identifier (GUID format).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update Referral StatusREFERRALROCK_POST_REFERRALS_STATUSAcciónTool 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.
REFERRALROCK_POST_REFERRALS_STATUSAcciónTool 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.
Parámetros de entrada
amountanyReferral reward amount as a decimal value
statusstringObligatorioNew status value for the referral. Must be one of: 'pending', 'qualified', 'approved', or 'denied'
programIdstringIdentifier of the associated program
publicNotestringCustomer-facing note about the status update
referralIdstringObligatorioIdentifier for the referral to update
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update Referral DetailsREFERRALROCK_POST_REFERRAL_UPDATEAcciónTool 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.
REFERRALROCK_POST_REFERRAL_UPDATEAcciónTool 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.
Parámetros de entrada
updatesobject[]ObligatorioList of referral updates to process. Each item contains a query to identify the referral and the fields to update.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Issue Reward to MemberREFERRALROCK_POST_REWARDS_ISSUEAcciónTool 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.
REFERRALROCK_POST_REWARDS_ISSUEAcciónTool 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.
Parámetros de entrada
notestringA message sent to the reward recipient.
rewardIdstringObligatorioThe unique identifier for the reward being issued.
recipientInfostringFor PayPal, include the email address of the recipient. (Deprecated parameter)
overrideIneligiblebooleanAllows you to override eligibility date rules. Issue rewards with eligibility dates in the future.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove RewardsREFERRALROCK_POST_REWARDS_REMOVEAcciónTool 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.
REFERRALROCK_POST_REWARDS_REMOVEAcciónTool 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.
Parámetros de entrada
rewardIdsstring[]ObligatorioList of reward identifiers to be removed. Each ID should be a string representing a reward in the referral program.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not