Authorizations
API key passed as a Bearer token in the Authorization header. You can find your API Key on Your FirstPromoter Dashboard. Navigate to Settings → Integrations → Manage API Keys
Headers
Account id. You can find your Account ID on Your FirstPromoter Dashboard. Navigate to Settings → Integrations
Path Parameters
ID of the referral
Body
Email address of the referral, this is required if the uid is null
UID of the referral, this is required if the email is null
Username of the referral.
Note: Reach out to us on support if you need this.It needs to be enabled before you can use it.
Promoter campaign ID, you can obtain this for each promoter form the promoters endpoint. It is the id that pairs a promoter to a campaign. Not the campaign id.
Find by attribute. Required when id parameter is an email, uid, or username instead of an ID.
Your request should follow the format https://v2.firstpromoter.com/api/v2/company/referrals/{email or uid or username}
email
, uid
, username
Percentage vale of the split between 0 and 100.
Note: Reach out to us on support if you need this.It needs to be enabled before you can use it.
Promoter campaign ID, on which you want the split on.
Note: Reach out to us on support if you need this.It needs to be enabled before you can use it.
Response
Referral updated successfully
Id of the referral
Email address of the referral
uid of the referral
State of the referral
subscribed
, signup
, active
, cancelled
, refunded
, denied
, pending
, moved
Additional metadata of the referral
Entry source of the referral. This shows where the referral was captured from. Cookie is set if the referral was captured using the tid cookie, Coupon is for when the referral is captured via a coupon code. Manual admin is for when the referral is added manually by an admin. Manual affiliate is for when the referral is added manually by an affiliate.
api
, coupon
, cookie
, manual_admin
, manual_affiliate
Date and time when the referral was created
Date and time when the referral became a customer
Fraud check result of the referral
no_suspicion
, same_ip_suspicion
, same_promoter_email
, ad_source
Email address of the user who created the referral