Active with remarks |
---|
This application needs additional settings. Please follow the documentation below to create your connection. |
The UpViral modules enable you to monitor, add or retrieve contacts and add points in your UpViral account.
Prerequisites
-
An UpViral account
In order to use UpViral with Boost.space Integrator, it is necessary to have an UpViral account. If you do not have one, you can create an UpViral account at upviral.com/pricing.
![]() |
Note |
---|---|
The module dialog fields that are displayed in bold (in the Boost.space Integrator scenario, not in this documentation article) are mandatory! |
To connect your UpViral account to Boost.space Integrator you need to obtain the API Key.
-
Log in to your UpViral account.
-
Click on your profile icon in the top-right corner and select the My Profile option.
-
Go to the API Key tab and copy the provided API Key.
-
Go to Boost.space Integrator and open the UpViral module’s Create a connection dialog.
-
Enter the API Key you have copied in step 3 to the respective field and click the Continue button to establish the connection.
The connection has been established. You can proceed with setting up the module.
Retrieves contact details when a new contact (lead) is added to the specified campaign.
|
|
|
Select the campaign you want to watch for new contacts. |
|
Set the maximum number of contacts Boost.space Integrator will return during one execution cycle. |
Adds a new contact to the specified campaign.
|
|
|
Select or map the campaign you want to add a contact to. |
|
Enter the email address of the contact. |
|
Enter the user’s name. |
|
Enter the unique referral code (Last part of unique Referral URL). For example – https://upvir.al/ref/XXXX, Referral Code will be XXXX. This will be the referral code of the person who referred to this new contact. The original participant will get the credit for this new contact. |
|
The campaign’s custom fields, which you add in your lead page editor or advanced settings. For more details please refer to this article. |
Retrieves contact details.
|
|
|
Select or map the campaign you want to retrieve a contact from. |
|
Select whether you want to specify the contact by ID or by an email address. |
|
Select or map contact or enter the email address you want to retrieve contact details for. |
Adds points to the user.
|
|
|
Select or map the campaign that contains the contact you want to add points to. |
|
Select or map the contact you want to add points to. |
|
Enter the number of points to be added. |
Returns contacts. The result can be filtered by the number of points.
|
|
|
Select or map the campaign that you want to list contacts from. |
|
Enable this checkbox to filter contacts by points. |
|
Select one of the operators (>, =, <). |
|
Enter the number of points to filter results by. |
|
Set the maximum number of contacts Boost.space Integrator will return during one execution cycle. |
Allows you to perform a custom API call.
|
||||
|
Enter a path relative to
|
|||
|
Select the HTTP method you want to use:
|
|||
|
Enter the UpViral method. It can be found in the API documentation under the uvmethod parameter: ![]() |
|||
|
Enter the required parameters. |
The following API call returns contacts in your UpViral account:
URL:
/v1
HTTP Method:
POST
UpViral Method:
get_leads
Parameters:
Key: campaign_id
Value: {{campaignID}}

Matches of the search can be found in the module’s Output under Bundle > Body > data > leads.
In our example, 2 contacts were returned:

Do you need help with something specific regarding UpViral?
We are here for you.
Get support on the road to success from real experts.
We will help you set up your business processes, create connections from your current IT stack, and set up data analysis.
Get in touch