All integrations

Referral Rock

MARKETING · MARKETING

Referral programs, their members, stats, and share URLs in the account they connected.

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

referralrock_delete_api_email_removeunsubscribeWRITE

Remove Email Address from unsubscribe list. Same action as referralrock_post_api_email_removeunsubscribe; Referral Rock serves it on both verbs. (DELETE /api/email/removeunsubscribe)

api
referralrock_delete_api_hooksWRITE

This endpoint allows a client to unsubscribe from an event of interest. Afterwards, when the event occurs, the no data will be sent to the previously specified url. (DELETE /api/hooks)

api
referralrock_delete_api_members_removeWRITE

Deletes members of a referral program. For each member, a query object is specified to identiy the member to delete. At a minimum, a query object requires either a valid value in primaryInfo or a valid element in both the secondaryInfo and tertiaryInfo elements. A member will only be deleted if it can be uniquely identifier by the query. Same action as referralrock_post_api_members_remove; Referral Rock serves it on both verbs. (DELETE /api/members/remove)

api
referralrock_delete_api_referral_removeWRITE

Deletes referrals in a referral program. For each referral, a query object is specified to identiy the referral to delete. At a minimum, a query object requires either a valid value in primaryInfo or a valid element in both the secondaryInfo and tertiaryInfo elements. A referral will only be deleted if it can be uniquely identifier by the query. Same action as referralrock_post_api_referral_remove; Referral Rock serves it on both verbs. (DELETE /api/referral/remove)

api
referralrock_delete_api_rewards_removeWRITE

Deletes a reward from a member or referral of a referral program. Same action as referralrock_post_api_rewards_remove; Referral Rock serves it on both verbs. (DELETE /api/rewards/remove)

api
referralrock_get_api_email_getunsubscribedREAD

Get all unsubscribed emails or by email address. (GET /api/email/getunsubscribed)

api
referralrock_get_api_hooks_history_by_eventnameREAD

DEPRECATED - use GET api/v2/hooks/history/{eventName} instead. That version returns each event in the shape our webhooks actually send, and accepts a count parameter. Two differences to expect when you switch: it returns at most 25 items unless you pass a larger count, and it omits any event it cannot render in webhook shape (EmailUnsubscribed is stored as a bare email address, so v2 returns nothing for it). This version returns the raw log shape and applies no record limit, so a busy event can produce a very large response. History is kept for about seven days. (GET /api/hooks/history/{eventName})

api
referralrock_get_api_membersREAD

Get a list of members ordered by create date. The list can be filtered by program. The offset and count parameters can be used to specify the set of members. (GET /api/members)

api
referralrock_get_api_memberstats_getsingleREAD

Get statistics about a member's sharing, referral, and reward activities. (GET /api/memberstats/getsingle)

api
referralrock_get_api_payouts_by_idREAD

Get a list of payouts. (GET /api/payouts/{id})

api
referralrock_get_api_payouts_pendingREAD

A collection of payouts yet to be transferred to a member. This can be filtered by the member. (GET /api/payouts/pending)

api
referralrock_get_api_payouts_transactionsREAD

A collection of transactions that represent payouts transferred to participants of a referral program. This can be filtered by recipient or transactionId. (GET /api/payouts/transactions)

api
referralrock_get_api_program_getsingleREAD

Get a single program by name. (GET /api/program/getsingle)

api
referralrock_get_api_programsREAD

Get a list of referral programs. The offset and count parameters can be used to specify the set of programs. (GET /api/programs)

api
referralrock_get_api_referral_singleREAD

Get a single Referral. At least one of email, referralId or externalId is required. (GET /api/referral/single)

api
referralrock_get_api_referralsREAD

Get a list of referrals ordered by create date. The list can be filtered by program. The offset and count parameters can be used to specify the set of referrals. (GET /api/referrals)

api
referralrock_get_api_rewardrulesREAD

Gets a list of member rewards rules. (GET /api/rewardrules)

api
referralrock_get_api_rewardsREAD

Gets a list of rewards ordered by create date. The offset and count parameters can be used to specify the set of rewards. (GET /api/rewards)

api
referralrock_get_api_v2_hooks_history_by_eventnameREAD

Get a list of history items with the response matching the output of our webhooks, newest first. History is kept for about seven days, so a request returns up to that much or up to 5000 items, whichever is reached first. (GET /api/v2/hooks/history/{eventName})

api
referralrock_post_api_customerfeedWRITE

Each customer added will update any matching referrals to approved and add them as a pre-loaded member based on your account's settings. Approving a referral triggers any configured rewards; customers with no matching referral are added as pre-loaded members to every program with the Preload New Customers setting on. (POST /api/customerfeed)

api
referralrock_post_api_customerfeedsWRITE

Each customer added will update any matching referrals to approved and add them as a pre-loaded member based on your account's settings. Each record is processed independently and the response includes a per-record outcome in the same order as the input. Larger integrations should use the CSV bulk import in the admin UI. (POST /api/customerfeeds)

api
referralrock_post_api_email_removeunsubscribeWRITE

Remove Email Address from unsubscribe list. (POST /api/email/removeunsubscribe)

api
referralrock_post_api_email_unsubscribeWRITE

Unsubscribe Email Address. (POST /api/email/unsubscribe)

api
referralrock_post_api_hooksWRITE

This endpoint allows a client to specify a url to send data to in the event that an event of interest occurs. When these events occur, the url will receive a POST request with a JSON body of the element in question. These element will match the elements contained in a GET call to the Referral Rock Apis. (POST /api/hooks)

api
referralrock_post_api_invitefeedWRITE

DEPRECATED: Please use the customer feed endpoint instead: https://api.referralrock.com/Help/Api/POST-api-customerfeed Add a single contact to be used with automatic invites. (POST /api/invitefeed)

api
referralrock_post_api_memberaccessWRITE

DEPRECATED: Please use the memberaccessurls endpoint instead: https://api.referralrock.com/Help/Api/POST-api-memberaccessurls. (POST /api/memberaccess)

api
referralrock_post_api_memberaccessurlsWRITE

Create a custom member share experience or securely embed the Member Portal or Share Widget in your app. This endpoint returns a Member's unique share links and access links for their portal or share widget. Exactly one search parameter is required: memberId, referralCode, emailAddress or externalId. (POST /api/memberaccessurls)

api
referralrock_post_api_membersWRITE

Creates a new member and adds it to a referral program. (POST /api/members)

api
referralrock_post_api_members_removeWRITE

Deletes members of a referral program. For each member, a query object is specified to identiy the member to delete. At a minimum, a query object requires either a valid value in primaryInfo or a valid element in both the secondaryInfo and tertiaryInfo elements. A member will only be deleted if it can be uniquely identifier by the query. (POST /api/members/remove)

api
referralrock_post_api_members_updateWRITE

Updates members of a referral program. For each member, a query object is specified to identify the member to update and a member object is specified to identify the elements to update. At a minimum, a query object requires either a valid value in primaryInfo or a valid element in both the secondaryInfo and tertiaryInfo elements. A member will only be updated if it can be uniquely identifier by the query. (POST /api/members/update)

api
referralrock_post_api_payouts_transactionsWRITE

Payout pending rewards. Returns transactions of issued rewards. Pays out real rewards to program participants through the account's configured payout method; a completed payout cannot be reversed here. (POST /api/payouts/transactions)

api
referralrock_post_api_referral_removeWRITE

Deletes referrals in a referral program. For each referral, a query object is specified to identiy the referral to delete. At a minimum, a query object requires either a valid value in primaryInfo or a valid element in both the secondaryInfo and tertiaryInfo elements. A referral will only be deleted if it can be uniquely identifier by the query. (POST /api/referral/remove)

api
referralrock_post_api_referral_updateWRITE

Updates referrals in a referral program. For each referral, a query object is specified to identify the referral to update and a referral object is specified to identify the elements to update. At a minimum, a query object requires either a valid value in primaryInfo or a valid element in both the secondaryInfo and tertiaryInfo elements. A referral will only be updated if it can be uniquely identifier by the query. (POST /api/referral/update)

api
referralrock_post_api_referralactionWRITE

Creates a new Referral Action to be used for processing new recurring rewards. (POST /api/referralaction)

api
referralrock_post_api_referralsWRITE

Adds referral to a referral program based on a referral code from a member. (POST /api/referrals)

api
referralrock_post_api_referrals_statusWRITE

Updates the status of a referral. ("Going to be deprecated" please use POST api/referral/update). (POST /api/referrals/status)

api
referralrock_post_api_rewardsWRITE

Creates new rewards members and referrals of a referral program. Creates rewards that the program's rules may issue or pay out. (POST /api/rewards)

api
referralrock_post_api_rewards_issueWRITE

Issue a specific reward. Issuing a reward can deliver real value to its recipient through the program's configured reward method. (POST /api/rewards/issue)

api
referralrock_post_api_rewards_removeWRITE

Deletes a reward from a member or referral of a referral program. (POST /api/rewards/remove)

api
referralrock_post_api_rewards_updateWRITE

Updates rewards from a referral program. (POST /api/rewards/update)

api

Put Referral Rock behind one governed endpoint.

Same permissions, same audit trail, whatever else you connect next.