POST
/
add_to_campaign

Use this endpoint to add a promoter to another campaign. Your promoter will have multiple campaigns to promoter, each campaign with its own promotion, referral link and referral id.

You can identify promoters by: id, cust_id, auth_token, promoter_email or ref_id(referral id).

Authorizations

X-API-KEY
string
header
required

Query Parameters

id
string

Promoter's ID inside FirstPromoter

promoter_email
string

Email of the promoter

cust_id
string

Assigned customer/user ID

ref_id
string

Referral ID

auth_token
string

Authentication token generated when the promoter was created

campaign_id
string
required

ID of the campaign to add the promoter to. It can be found on the url bar when editing the campaign

Response

200 - application/json
auth_token
string

Authentication token generated when the promoter was created

created_at
string

ISO date string when the promoter signed up

current_balance
object

Promoter's current balance. This object can contain cash, credits, discount_per

cust_id
string

Your customer's user ID inside your application/system for the promoter. This will be included in the webhook event and can be used to identify the promoter in your system if you scribscibe for FirstPromoter's webhooks.

default_promotion_id
number

Promoter's default promotion id

default_ref_id
string

Promoter's default referral id

earnings_balance
object

Promoter's earnings balance. This object can contain cash, credits, discount_per

email
string

Promoter's email

id
integer

The promoter's ID inside FirstPromoter

note
string

A note/description of promoter

paid_balance
object

Promoter's paid balance. This object can contain cash, credits, discount_per

parent_promoter_id
string

Parent promoter id

pref
string

Promoter's parent referral id.

profile
object
promotions
object[]
status
enum<string>

Promoter's status

Available options:
approved,
pending,
denied
temp_password
string

A temporary password the promoter can use to log in to their dashboard if you don't use authentication tokens(auth_token) to sign promoters in automatically.

w8_form_url
string

The w8 form url

w9_form_url
string

The w9 form url