POST
/
signup
cURL
curl --request POST \
  --url https://v2.firstpromoter.com/api/v2/track/signup \
  --header 'Account-ID: <account-id>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "<string>",
  "uid": "<string>",
  "tid": "<string>",
  "ref_id": "<string>",
  "ip": "<string>",
  "created_at": "<string>",
  "skip_email_notification": true
}'
{
  "id": 45831611,
  "etype": "signup",
  "sale_amount": null,
  "original_sale_amount": null,
  "original_sale_currency": null,
  "event_id": null,
  "plan_id": null,
  "billing_period": null,
  "created_at": "2025-04-25T09:29:51.973Z",
  "referral": {
    "id": 29203686,
    "email": "[email protected]",
    "uid": null
  },
  "commissions": []
}

Authorizations

​
Authorization
string
header
required

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 section → Manage API Keys

Headers

​
Account-ID
string
required

Account id. You can find your Account ID on Your FirstPromoter Dashboard. Navigate to Settings → Integrations

Body

application/json
​
email
string
required

Email of the lead/sign-up. Required if uid is not provided.

​
uid
string

ID to match the sale with the lead if the email can be changed before the first sale. Required if email is not provided.

​
tid
string

Visitor tracking ID. It's set when the visitor tracking script tracks the referral visit on our system. The value is found inside _fprom_tid cookie. Required if ref_id is not provided.

​
ref_id
string

Default referral id of the promoter. Use this only when you want to assign the lead to a specific promoter. Required if tid is not provided.

​
ip
string

IP of the visitor who generated the sign up. It's used for fraud analysis.

​
created_at
string

ISO date string of the date of the signup event

​
skip_email_notification
boolean

Set this to true to skip email notifications. Default is false.

Response

Successful signup response

​
id
integer
Example:

45831611

​
etype
string
Example:

"signup"

​
sale_amount
integer | null
Example:

null

​
original_sale_amount
integer | null
Example:

null

​
original_sale_currency
string | null
Example:

null

​
event_id
string | null
Example:

null

​
plan_id
string | null
Example:

null

​
billing_period
string | null
Example:

null

​
created_at
string<date-time>
Example:

"2025-04-25T09:29:51.973Z"

​
referral
object
​
commissions
any[]
Example:
[]