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.

GrowSurf

The Growsurf 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 watch, create, update, and delete campaigns, participants, and participant rewards in your Growsurf account.

Getting Started with Growsurf

Prerequisites

A Growsurf account

In order to use Growsurf 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 Growsurf account. If you do not have one, you can create a Growsurf account at growsurf.com/signup.

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!

Connecting Growsurf to Boost.space Integrator

To connect your Growsurf account to Boost.space Integrator you need to obtain the API Key from your Growsurf account and insert it in the Create a connection dialog in the Boost.space Integrator module.

Log in to your Growsurf account.
Click Your Profile Icon > Account >Reveal, and copy the API key to your clipboard.
Go to Boost.space Integrator and open the Growsurf module’s Create a connection dialog.
In the Connection name field, enter a name for the connection.
In the API Key field, enter the API key copied in step 2 and click Continue.

The connection has been established.

Campaigns

Watch Campaign Ended

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 campaign ends.

WebhookA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers. Name	Enter a name for the webhook.
Connection	Establish a connection to your Growsurf account.

See the Connecting to Growsurf Webhook using Boost.space Integrator to add the webhook in your Growsurf account.

List Campaigns

Retrieves a list of your campaigns.

Connection	Establish a connection to your Growsurf account.
Limit	Set the maximum number of campaigns 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)..

Get a Campaign

Retrieves a campaign.

Connection	Establish a connection to your Growsurf account.
Campaign ID	Select the Campaign ID whose details you want to retrieve.

Participants

Watch New Participants

Triggers when a new participant is added or referred to your campaign.

Webhook Name	Enter a name for the webhook.
Connection	Establish a connection to your Growsurf account.

See the Connecting to Growsurf Webhook using Boost.space Integrator to add the webhook in your Growsurf account.

List Participants

Retrieves a list of participants in the campaign.

Connection	Establish a connection to your Growsurf account.
Campaign ID	Select the Campaign ID whose participants you want to list.
Limit	Set the maximum number of participants Boost.space Integrator should return during one scenario execution cycle.

Get Participants

Retrieves a single participant from a campaign.

Connection	Establish a connection to your Growsurf account.
Campaign ID	Select the Campaign ID whose participant details you want to retrieve.
Participant ID or Email	Select the Participant ID or enter the email address of the participant whose details you want to retrieve.

Create a Participant

Adds a participant to the campaign.

Connection	Establish a connection to your Growsurf account.
Campaign ID	Select the Campaign ID for which you want to add the participant.
Referred By	Select the reference if the participant is referred by any userCan use the system on a limited basis based on the rights assigned by the admin. More.
Referral StatusCreate statuses for each module separately to create an ideal environment for efficient and consistent work. More	Select the referral status: Credit Pending Credit Awarded
Email	Enter the email address of the participant.
First Name	Enter the first name of the participant.
Last Name	Enter the last name of the participant.
IP Address	Enter the IP address of the participant.
Metadata	Enter the key-value metadata for the participant.

Update a participant

Updates a participant within the campaign.

Connection	Establish a connection to your Growsurf account.
Campaign ID	Select the Campaign ID whose participant’s details you want to update.
Participant ID or Email	Select the Participant ID or the email address of the participant whose details you want to update.
Referred By	Select the reference if the participant is referred by any user.
Referral Status	Select the referral status: Credit Pending Credit Awarded
Email	Enter the email address of the participant.
First Name	Enter the first name of the participant.
Last Name	Enter the last name of the participant.
IP Address	Enter the IP address of the participant.
Metadata	Enter the key-value metadata for the participant.

Delete a Participant

Removes participants within the campaign.

Connecti0on	Establish a connection to your Growsurf account.
Campaign ID	Select the Campaign ID whose participant’s details you want to delete.
Participant ID or Email	Select the Participant ID or the email address of the participant you want to delete.

Participant Rewards

Watch New Participants

Triggers when a participant unlocks a reward (if the reward is double-sided, two events will 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... for both referrer and referee).

Webhook Name	Enter a name for the webhook.
Connection	Establish a connection to your Growsurf account.

See the Connecting to Growsurf Webhook using Boost.space Integrator to add the webhook in your Growsurf account.

List Participant Rewards

Retrieves a list of rewards earned by a participant.

Connection	Establish a connection to your Growsurf account.
Campaign ID	Select the Campaign ID whose participant’s rewards you want to list.
Participant ID or Email	Select the Participant ID or the email address of the participant whose rewards you want to list.
Limit	Set the maximum number of rewards Boost.space Integrator should return during one scenario execution cycle.

Delete a Participant Reward

Removes a reward that was earned by a participant.

Connection	Establish a connection to your Growsurf account.
Campaign ID	Select the Campaign ID whose participant’s rewards you want to delete.
Participant ID or Email	Select the Participant ID or the email address of the participant whose rewards you want to delete.
Reward ID	Select the Reward ID you want to delete.

Other

Make an API Call

Performs an arbitrary authorized API call.

Connection

Establish a connection to your Growsurf account.

URL

Enter a path relative to https://api.growsurf.com/. For example: /v2/campaigns

	Note
	For the list of available endpoints, refer to the Growsurf API Documentation.

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.

Example of Use – Get Participants

The following API call returns all the participants from your Growsurf account:

URL:

/v2/campaign/{campaign_id}/participants

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 > participants.

In our example, 2 participants were returned:

Connecting to Growsurf Webhook using Boost.space Integrator

Open any watch module, enter the details as mentioned in the respective module, click Save and copy the URL address to your clipboard.
Login to your Growsurf account. Open the campaign whose triggers you want to watch. Click Campaign Actions > Edit Campaign > Options > View All Integrations > WebhooksA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers..

Enter the URL address copied in step 1 and select the options for which you want to recevie the alerts.

The webhook is successfully enabled.