| Active with remarks |
|---|
| This application needs additional settings. Please follow the documentation below to create your own connectionUnique, active service acces point to a network. There are different types of connections (API key, Oauth…). More. |
The ReferralHero modulesThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More allow you to monitor, create, update, list, and delete the subscribers, referrals, rewards, and lists in your ReferralHero account.
Prerequisites
-
A ReferralHero account
In order to use ReferralHero with Boost.spaceCentralization and synchronization platform, where you can organize and manage your data. More IntegratorPart of the Boost.space system, where you can create your connections and automate your processes. More, it is necessary to have a ReferralHero account. If you do not have one, you can create a ReferralHero account at referralhero.com.
![[Note]](https://docs.boost.space/wp-content/themes/bsdocs/docs-parser/HTML/css/image/note.png) |
Note |
|---|---|
|
The moduleThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More dialog fields that are displayed in bold (in the Boost.space Integrator scenarioA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive. More, not in this documentation article) are mandatory! |
To connect your ReferralHero account to Boost.space Integrator you need to obtain the API Key from your ReferralHero account and insert it in the Create a connection dialog in the Boost.space Integrator module.
-
Log in to your ReferralHero account and open your Dashboard.
-
Click Account > API.
-
Copy the API tokenThe API token is a multi-digit code that allows a user to authenticate with cloud applications. More to your clipboard.
-
Go to Boost.space Integrator and open the ReferralHero module’s Create a connection dialog.
-
In the Connection name field, enter a name for the connection.
-
In the API TokenThe API token is a multi-digit code that allows a user to authenticate with cloud applications. More field, enter the token details copied in step 3, and click Continue.
The connection has been established.
See the Setting Up the ReferralHero Webhooks to add the webhookA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers. in your ReferralHero account.
TriggersEvery scenario has a trigger, an event that starts your scenario. A scenario must have a trigger. There can only be one trigger for each scenario. When you create a new scenario, the first module you choose is your trigger for that scenario. Create a trigger by clicking on the empty module of a newly created scenario or moving the... when a new subscriber is added to your campaign.
|
Webhook Name |
Enter a name for the webhook. |
|
Connection |
Triggers when a subscriber is deleted from your campaign.
|
Webhook Name |
Enter a name for the webhook. |
|
Connection |
Gets all the subscribers on a list.
|
Connection |
|
|
List UUID |
Select the List unique identifier (UUID) whose subscribers you want to list. |
|
Sort By |
Select the option to sort the subscribers. For example, |
|
Limit |
Set the maximum number of subscribers Boost.space Integrator should return during one scenario execution cycleA cycle is the operation and commit/rollback phases of scenario execution. A scenario may have one or more cycles (one is the default).. |
Retrieves a subscriber.
|
Connection |
|
|
List UUID |
Select the List unique identifier (UUID) whose subscribers you want to list. |
|
Search By |
Select the option to search the subscriber:
|
|
|
Select the email address of the subscriber whose details you want to retrieve. Only verified subscribers can be retrieved. If you try to retrieve a non-verified subscriber, it will return a subscriber_not_found errorService is unavailable due to a failure, a service responds with unexpected data or the validation of input data fails. More. |
|
ID |
Select the ID of the subscriber whose details you want to retrieve.Only verified subscribers can be retrieved. If you try to retrieve a non-verified subscriber, it will return a subscriber_not_found error. |
Creates a new subscriber.
|
Connection |
|
|
List UUID |
Select the List ID in which you want to create a subscriber. |
|
|
Enter teh subscriber’s email address. |
|
Hosting URL |
Enter the campaign URL address from which the subscriber had subscribed. |
|
Name |
Enter the subscriber name. |
|
Extra Field |
Enter any additional field for the subscriber. For example, |
|
Extra Field 1 |
Enter any additional field for the subscriber. For example, |
|
Referral |
Enter a referrer for the subscriber by providing the referrer’s referral code or email. |
|
Points |
Enter the number of points allocated for the subscriber. This field is applicable only for contest campaigns. |
|
Double Optin |
Select whether the subscriber had opted in for receiving the notifications for the confirmation. |
|
Source |
Enter teh source from where the subscriber has signed up. For example, webinar. |
|
Device |
Enter teh device details used by the subscriber to sign up. |
|
Transaction ID |
Enter the Transaction ID of the subscriber subscription. This information is useful when tracking referrals for purchases. |
|
Conversion Strategy |
Enter the referral type. This information is used for creating reports. |
|
Conversion Value |
Enter the referral amount. |
Updates a subscriber.
|
Connection |
|
|
List UUID |
Select the List ID in which you want to create a subscriber. |
|
Subscriber ID |
Select the Subscriber ID whose details you want to update. Only verified subscribers can be retrieved. Trying to retrieve a non-verified subscriber will return a subscriber_not_found error. |
|
|
Enter teh subscriber’s email address. |
|
Name |
Enter the subscriber name. |
|
Extra Field |
Enter any additional field for the subscriber. For example, |
|
Extra Field 1 |
Enter any additional field for the subscriber. For example, |
|
Points |
Enter the number of points allocated for the subscriber. This field is applicable only for contest campaigns. |
Deletes a subscriber.
|
Connection |
|
|
List UUID |
Select the List unique identifier (UUID) whose subscriber’s details you want to delete. |
|
Subscriber ID |
Select the Subscriber ID you want to delete. |
Confirms a Referral.
|
Connection |
|
|
List UUID |
Select the List unique identifier (UUID) whose subscriber’s referral you want to confirm. |
|
Subscriber ID |
Select the subscriber ID whose referral you want to confirm. Only verified subscribers can be retrieved. If you try to retrieve a non-verified subscriber, it will return a subscriber_not_found error. |
Gets all the lists/campaigns in your account.
|
Connection |
|
|
Limit |
Set the maximum number of lists Boost.space Integrator should return during one scenario execution cycle. |
Creates all the lists/campaigns in your account.
|
Connection |
|
|
Name |
Enter a name for the list. |
|
Website |
Enter the URL address of the campaign referral. |
See the Setting Up the ReferralHero Webhooks to add the webhook in your ReferralHero account.
Triggers when a subscriber unlocks a reward.
|
Webhook Name |
Enter a name for the webhook. |
|
Connection |
Gets a list of rewards.
|
Connection |
|
|
List UUID |
Select the List ID whose rewards you want to list. |
|
Limit |
Set the maximum number of lists Boost.space Integrator should return during one scenario execution cycle. |
Performs an arbitrary authorized API call.
|
Connection |
||||
|
URL |
Enter a path relative to
|
|||
|
Method |
Select the HTTP method you want to use: GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry. |
|||
|
Headers |
Enter the desired request headers. You don’t have to add authorization headers; we already did that for you. |
|||
|
Query String |
Enter the request query string. |
|||
|
Body |
Enter the body content for your API call. |
The following API call returns all the subscribers from your ReferralHero account:
URL:
/v2/lists/<list_UUID>/subscribers
Method:
GET
Matches of the search can be found in the module’s Output under BundleA bundle is a chunk of data and the basic unit for use with modules. A bundle consists of items, similar to how a bag may contain separate, individual items. More > Body > data > subscribers.
In our example, 3 subscribers were returned:
-
Open any Watch module, establish a connection as mentioned in the respective modules, click Save and copy the URL address to your clipboard. Click OK and save the triggerEvery scenario has a trigger, an event that starts your scenario. A scenario must have a trigger. There can only be one trigger for each scenario. When you create a new scenario, the first module you choose is your trigger for that scenario. Create a trigger by clicking on the empty module of a newly created scenario or moving the....
-
Log in to your ReferralHero account.
-
Select the campaign for which you want to add the webhooksA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers..
-
Click Installation Instructions > Integrations > Webhooks > +New Webhook.
-
Add the URL address copied in step 1 and select the events for which you want to receive the triggers. When you add the URL address in the URL field, remove the prefix https://as the copied URL already has that part.
-
Click Create Webhook.
You have successfully added the webhook.
Go to Boost.space Integrator and run the webhook scenario to receive the triggers for the selected events.