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
headerrequired

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
id
integer

The promoter's ID inside FirstPromoter

status
enum<string>

Promoter's status

Available options:
approved,
pending,
denied
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.

email
string

Promoter's email

created_at
string

ISO date string when the promoter signed up

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.

default_promotion_id
number

Promoter's default promotion id

pref
string

Promoter's parent referral id.

default_ref_id
string

Promoter's default referral id

note
string

A note/description of promoter

w8_form_url
string

The w8 form url

w9_form_url
string

The w9 form url

parent_promoter_id
string

Parent promoter id

earnings_balance
object

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

current_balance
object

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

paid_balance
object

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

auth_token
string

Authentication token generated when the promoter was created

profile
object
promotions
object[]