{
"message": "Error. Email and uid can not be blank!"
}
{
"message": "Visitor invalid, not found or you are trying to use the signup tracking test via API which doesn't work on API calls."
}
{
"transaction_id": "there is already a signup event registered on this lead"
}
Capture a lead when they sign-up or fill an optin form. This endpoint is used to track leads and sign-ups. It’s not for tracking the actual sales and commissions.
Sign-ups are tracked as leads in FirstPromoter so when a person referred by the promoter/affiliate signs up, a new referral should be added inside FirstPromoter (you can see them inside the Referrals section as Leads).
Using sub IDs, postbacks or ad tracking? Install the tracking script so it sets the _fprom_tid cookie when a visitor clicks a referral link, then send that cookie’s value in the tid parameter.
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
Option 1
Option 2
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
Show child attributes
commissions
any[]
Example:
[]
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FirstPromoter Docs","description":"FirstPromoter developer docs: set up affiliate and referral tracking, connect billing and payout providers, receive webhooks, and use the REST API and MCP server.","colors":{"primary":"#2497F3","light":"#42A5F5","dark":"#1A1C25"},"logo":{"light":"https://mintcdn.com/firstpromoter/Qml53iAwCwPGiKRZ/logo/light.svg?fit=max\u0026auto=format\u0026n=Qml53iAwCwPGiKRZ\u0026q=85\u0026s=17d35344b27497f795682da8932295c9","dark":"https://mintcdn.com/firstpromoter/Qml53iAwCwPGiKRZ/logo/dark.svg?fit=max\u0026auto=format\u0026n=Qml53iAwCwPGiKRZ\u0026q=85\u0026s=ef23e747176d9a87b5ddf122595793f8"},"favicon":"https://mintcdn.com/firstpromoter/rNk-Jdvp2vdjAvd9/favicon.png?fit=max\u0026auto=format\u0026n=rNk-Jdvp2vdjAvd9\u0026q=85\u0026s=7faf17e323609b0fef661b9a9fe49ebc","navbar":{"links":[{"href":"mailto:support@firstpromoter.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://login.firstpromoter.com/"}},"footer":{"socials":{"x":"https://x.com/firstpromoter","linkedin":"https://www.linkedin.com/company/first-promoter","facebook":"https://www.facebook.com/firstpromoter","github":"https://github.com/firstpromoter"},"links":[{"header":"Product","items":[{"label":"Features","href":"https://firstpromoter.com/features"},{"label":"Integrations","href":"https://firstpromoter.com/integrations"},{"label":"Pricing","href":"https://firstpromoter.com/pricing"},{"label":"Changelog","href":"https://changelog.firstpromoter.com/"},{"label":"Stripe app","href":"https://marketplace.stripe.com/apps/firstpromoter"}]},{"header":"Company","items":[{"label":"About us","href":"https://firstpromoter.com/about-us"},{"label":"Careers","href":"https://firstpromoter.com/careers"},{"label":"Blog","href":"https://firstpromoter.com/blog"},{"label":"Case studies","href":"https://firstpromoter.com/casestudy"},{"label":"Affiliate program","href":"https://firstpromoter.com/affiliate-program"}]},{"header":"Help","items":[{"label":"Help center","href":"https://help.firstpromoter.com/en"},{"label":"Contact support","href":"mailto:support@firstpromoter.com"},{"label":"Log in","href":"https://app.firstpromoter.com/login"}]},{"header":"Legal","items":[{"label":"Privacy policy","href":"https://firstpromoter.com/privacy"},{"label":"Terms of service","href":"https://firstpromoter.com/terms"}]}]},"search":{"prompt":"Search guides, integrations and API endpoints..."},"seo":{"metatags":{"canonical":"https://docs.firstpromoter.com"},"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude","cursor","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"firstpromoter","hasAudioNarration":false,"actualSubdomain":"firstpromoter","customDomains":["docs.firstpromoter.com"],"gitSource":{"type":"github","owner":"firstpromoter","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6b006a04286e5a4832624336","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"Documentation","count":253},{"language":"default","tag":"API Reference","count":83},{"language":"default","tag":"Integration Options","count":43},{"language":"default","tag":"Affiliate API Reference","count":32},{"language":"default","tag":"Promoters","count":25},{"language":"default","tag":"Platform","count":23},{"language":"default","tag":"Custom","count":9},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Reports","count":8},{"language":"default","tag":"Payouts","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference-v2/api-admin/tracking-api/leads-and-signups","slug":"/api-reference-v2/api-admin/tracking-api/leads-and-signups","pageMetadata":{"title":"Tracking leads and sign-ups","description":"Track a lead or signup from your backend and attribute it to a promoter using the visitor's tid or ref_id.","openapi":"openapi-v2-tracking POST /signup","href":"/api-reference-v2/api-admin/tracking-api/leads-and-signups"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Track a lead or signup from your backend and attribute it to a promoter using the visitor’s tid or ref_id.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Tip}=_components;if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_components.p,{children:[`Capture a lead when they sign-up or fill an optin form. This endpoint is used to track leads and sign-ups. It’s not for tracking the actual sales and commissions. `,_jsx(`br`,{}),` `,_jsx(`br`,{}),` Sign-ups are tracked as leads in FirstPromoter so when a person referred by the promoter/affiliate signs up, a new referral should be added inside FirstPromoter `,_jsxs(_components.strong,{children:[`(you can see them inside the `,_jsx(_components.code,{children:`Referrals`}),` section as `,_jsx(_components.code,{children:`Leads`}),`)`]}),`. `,_jsx(`br`,{}),_jsx(`br`,{}),_jsxs(Tip,{children:[`Using sub IDs, postbacks or ad tracking? Install the tracking script so it sets the `,_jsx(_components.code,{children:`_fprom_tid`}),` cookie when a visitor clicks a referral link, then send that cookie’s value in the `,_jsx(_components.code,{children:`tid`}),` parameter.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Tracking leads and sign-ups","description":"Track a lead or signup from your backend and attribute it to a promoter using the visitor's tid or ref_id.","openapi":"openapi-v2-tracking POST /signup","href":"/api-reference-v2/api-admin/tracking-api/leads-and-signups"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/firstpromoter/8ad42af542d542c7/downloadables/fpr-prox.js"],"openApiReferenceData":{"operation":{"description":"Track a lead or signup from your backend and attribute it to a promoter using the visitor's tid or ref_id.","requestBody":"7860dbfc-b81b-4545-8170-17a6fe6f982f","parameters":["199b35d1-6cd7-4446-8760-07d6883dccc0"],"responses":{"200":"154f01dd-741b-4d8d-93f2-437840c5908c","400":"c191b904-50e5-4599-84b3-0b465fcc3dcd","404":"226a4f94-6ec2-4256-8a8d-e35883b37182","422":"0dc1d764-90e3-419f-b1b1-fae1ee622908"},"method":"post","type":"path","servers":["27b22f66-6dd3-4979-a4da-c08d25b99526"],"security":["1485d0a3-93c6-4f07-89d6-fcd3e2644ad4"],"path":"/signup","baseUrlOptions":["https://api.firstpromoter.com/api/v2/track"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"199b35d1-6cd7-4446-8760-07d6883dccc0":{"name":"Account-ID","in":"header","required":true,"description":"Account id. You can find your Account ID on Your FirstPromoter Dashboard. Navigate to Settings → Integrations","schema":{"type":"string","isRequired":true,"description":"Account id. You can find your Account ID on Your FirstPromoter Dashboard. Navigate to Settings → Integrations","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["email"],"properties":{"email":{"type":"string","description":"Email of the lead/sign-up. Required if uid is not provided.","isRequired":true,"uniqueKey":"oneOf.0.email","typeLabel":"string"},"uid":{"type":"string","description":"ID to match the sale with the lead if the email can be changed before the first sale. Required if email is not provided.","uniqueKey":"oneOf.0.uid","typeLabel":"string"},"tid":{"type":"string","description":"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.","uniqueKey":"oneOf.0.tid","typeLabel":"string"},"ref_id":{"type":"string","description":"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.","uniqueKey":"oneOf.0.ref_id","typeLabel":"string"},"ip":{"type":"string","description":"IP of the visitor who generated the sign up. It's used for fraud analysis.","uniqueKey":"oneOf.0.ip","typeLabel":"string"},"created_at":{"type":"string","description":"ISO date string of the date of the signup event","uniqueKey":"oneOf.0.created_at","typeLabel":"string"},"skip_email_notification":{"type":"boolean","description":"Set this to true to skip email notifications. Default is false.","uniqueKey":"oneOf.0.skip_email_notification","typeLabel":"boolean"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["uid"],"properties":{"uid":{"type":"string","description":"ID to match the sale with the lead if the email can be changed before the first sale. Required if email is not provided.","isRequired":true,"uniqueKey":"oneOf.1.uid","typeLabel":"string"},"email":{"type":"string","description":"Email of the lead/sign-up. Required if uid is not provided.","uniqueKey":"oneOf.1.email","typeLabel":"string"},"tid":{"type":"string","description":"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.","uniqueKey":"oneOf.1.tid","typeLabel":"string"},"ref_id":{"type":"string","description":"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.","uniqueKey":"oneOf.1.ref_id","typeLabel":"string"},"ip":{"type":"string","description":"IP of the visitor who generated the sign up. It's used for fraud analysis.","uniqueKey":"oneOf.1.ip","typeLabel":"string"},"created_at":{"type":"string","description":"ISO date string of the date of the signup event","uniqueKey":"oneOf.1.created_at","typeLabel":"string"},"skip_email_notification":{"type":"boolean","description":"Set this to true to skip email notifications. Default is false.","uniqueKey":"oneOf.1.skip_email_notification","typeLabel":"boolean"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"email":"\u003cstring>","uid":"\u003cstring>","tid":"\u003cstring>","ref_id":"\u003cstring>","ip":"\u003cstring>","created_at":"\u003cstring>","skip_email_notification":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"154f01dd-741b-4d8d-93f2-437840c5908c":{"description":"Successful signup response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","example":45831611,"uniqueKey":"id","typeLabel":"integer"},"etype":{"type":"string","example":"signup","uniqueKey":"etype","typeLabel":"string"},"sale_amount":{"oneOf":[{"type":"integer","example":null,"uniqueKey":"sale_amount.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"uniqueKey":"sale_amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"sale_amount","typeLabel":"integer | null"},"original_sale_amount":{"oneOf":[{"type":"integer","example":null,"uniqueKey":"original_sale_amount.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"uniqueKey":"original_sale_amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"original_sale_amount","typeLabel":"integer | null"},"original_sale_currency":{"oneOf":[{"type":"string","example":null,"uniqueKey":"original_sale_currency.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"original_sale_currency.oneOf.1","typeLabel":"null"}],"uniqueKey":"original_sale_currency","typeLabel":"string | null"},"event_id":{"oneOf":[{"type":"string","example":null,"uniqueKey":"event_id.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"event_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"event_id","typeLabel":"string | null"},"plan_id":{"oneOf":[{"type":"string","example":null,"uniqueKey":"plan_id.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"plan_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"plan_id","typeLabel":"string | null"},"billing_period":{"oneOf":[{"type":"string","example":null,"uniqueKey":"billing_period.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"billing_period.oneOf.1","typeLabel":"null"}],"uniqueKey":"billing_period","typeLabel":"string | null"},"created_at":{"type":"string","format":"date-time","example":"2025-04-25T09:29:51.973Z","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"referral":{"type":"object","properties":{"id":{"type":"integer","example":29203686,"uniqueKey":"referral.id","typeLabel":"integer"},"email":{"type":"string","example":"testme@test1.com","uniqueKey":"referral.email","typeLabel":"string"},"uid":{"oneOf":[{"type":"string","example":null,"uniqueKey":"referral.uid.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"referral.uid.oneOf.1","typeLabel":"null"}],"uniqueKey":"referral.uid","typeLabel":"string | null"}},"uniqueKey":"referral","typeLabel":"object"},"commissions":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"commissions.items.[INDEX]","typeLabel":"any"},"example":[],"uniqueKey":"commissions","typeLabel":"any[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"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":"testme@test1.com","uid":null},"commissions":[]}}},"exampleType":"generated"}},"exampleType":"generated"},"c191b904-50e5-4599-84b3-0b465fcc3dcd":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Error. Email and uid can not be blank!","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Error. Email and uid can not be blank!"}}},"exampleType":"generated"}},"exampleType":"generated"},"226a4f94-6ec2-4256-8a8d-e35883b37182":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Visitor invalid, not found or you are trying to use the signup tracking test via API which doesn't work on API calls.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Visitor invalid, not found or you are trying to use the signup tracking test via API which doesn't work on API calls."}}},"exampleType":"generated"}},"exampleType":"generated"},"0dc1d764-90e3-419f-b1b1-fae1ee622908":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"transaction_id":{"type":"string","example":"there is already a signup event registered on this lead","uniqueKey":"transaction_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"transaction_id":"there is already a signup event registered on this lead"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"1485d0a3-93c6-4f07-89d6-fcd3e2644ad4":{"BearerAuth":{"type":"http","scheme":"bearer","description":"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","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"27b22f66-6dd3-4979-a4da-c08d25b99526":{"url":"https://api.firstpromoter.com/api/v2/track"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"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","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"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","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference-v2/api-admin/tracking-api/openapi-v2-tracking.json"},"subdomain":"firstpromoter","siteName":"FirstPromoter Docs","title":"Tracking leads and sign-ups - FirstPromoter Docs","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference-v2/api-admin/tracking-api/leads-and-signups","matchLevel":0},"v1":{"href":"/introduction","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T13:53:59.715Z","originalFileLocation":"api-reference-v2/api-admin/tracking-api/leads-and-signups.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Track a lead or signup from your backend and attribute it to a promoter using the visitor\u0026#x27;s tid or ref_id.\">\u003cmeta data-mint-head name=\"application-name\" content=\"FirstPromoter Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Tracking leads and sign-ups - FirstPromoter Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Track a lead or signup from your backend and attribute it to a promoter using the visitor\u0026#x27;s tid or ref_id.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FirstPromoter Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api/leads-and-signups\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://firstpromoter.mintlify.site/_mintlify/api/og/v2?division=Tracking+Api\u0026amp;title=Tracking+leads+and+sign-ups\u0026amp;description=Track+a+lead+or+signup+from+your+backend+and+attribute+it+to+a+promoter+using+the+visitor%27s+tid+or+ref_id.\u0026amp;theme=fff9650e72028c28308bb6bc\u0026amp;signature=8b1be909a470f9eb5fda513a9156b432abe0d591af280e8e08244b2aef0bb395\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Tracking leads and sign-ups - FirstPromoter Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Track a lead or signup from your backend and attribute it to a promoter using the visitor\u0026#x27;s tid or ref_id.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://firstpromoter.mintlify.site/_mintlify/api/og/v2?division=Tracking+Api\u0026amp;title=Tracking+leads+and+sign-ups\u0026amp;description=Track+a+lead+or+signup+from+your+backend+and+attribute+it+to+a+promoter+using+the+visitor%27s+tid+or+ref_id.\u0026amp;theme=fff9650e72028c28308bb6bc\u0026amp;signature=8b1be909a470f9eb5fda513a9156b432abe0d591af280e8e08244b2aef0bb395\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FirstPromoter Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2497F3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api/leads-and-signups\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference-v2/api-admin/tracking-api/leads-and-signups.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.firstpromoter.com/#organization\",\"name\":\"FirstPromoter Docs\",\"url\":\"https://docs.firstpromoter.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/firstpromoter/Qml53iAwCwPGiKRZ/logo/light.svg?fit=max\u0026auto=format\u0026n=Qml53iAwCwPGiKRZ\u0026q=85\u0026s=17d35344b27497f795682da8932295c9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.firstpromoter.com#website\",\"name\":\"FirstPromoter Docs\",\"url\":\"https://docs.firstpromoter.com\",\"publisher\":{\"@id\":\"https://docs.firstpromoter.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api/leads-and-signups#webpage\",\"url\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api/leads-and-signups\",\"name\":\"Tracking leads and sign-ups\",\"description\":\"Track a lead or signup from your backend and attribute it to a promoter using the visitor's tid or ref_id.\",\"dateModified\":\"2026-11-20T13:53:59.715Z\",\"isPartOf\":{\"@id\":\"https://docs.firstpromoter.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api/leads-and-signups#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api/leads-and-signups#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"FirstPromoter Docs\",\"item\":\"https://docs.firstpromoter.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tracking leads and sign-ups\",\"item\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api/leads-and-signups\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api/leads-and-signups#apireference\",\"headline\":\"Tracking leads and sign-ups\",\"name\":\"Tracking leads and sign-ups\",\"description\":\"Track a lead or signup from your backend and attribute it to a promoter using the visitor's tid or ref_id.\",\"url\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api/leads-and-signups\",\"mainEntityOfPage\":{\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api/leads-and-signups#webpage\"},\"dateModified\":\"2026-11-20T13:53:59.715Z\",\"publisher\":{\"@id\":\"https://docs.firstpromoter.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.firstpromoter.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FirstPromoter Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"FirstPromoter Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference-v2/api-admin/tracking-api/leads-and-signups.md","siteName":"FirstPromoter Docs","nav":{"global":null,"versions":[{"version":"v2","anchors":[{"anchor":"Documentation","icon":"book-open","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"FirstPromoter API v2 Introduction","sidebarTitle":"Introduction","href":"/api-reference-v2/api-admin/introduction"},{"title":"FirstPromoter API v2 Authentication","sidebarTitle":"Authentication","href":"/api-reference-v2/api-admin/authentication"}]},{"group":"Batch Processes","pages":[{"openapi":"openapi-v2-batches get /batch_processes","title":"List in progress batch processes.","href":"/api-reference-v2/api-admin/batches/list-inprogress-batch-processes"},{"openapi":"openapi-v2-batches get /batch_processes/{id}","title":"Show batch process","href":"/api-reference-v2/api-admin/batches/show-batch-process"},{"description":"Check the progress of running batch processes so you can poll bulk actions until they finish.","openapi":"openapi-v2-batches get /batch_processes/progress","title":"Show progress","href":"/api-reference-v2/api-admin/batches/show-progress"}]},{"group":"Tracking Api","pages":[{"title":"Tracking leads and sign-ups","openapi":"openapi-v2-tracking POST /signup","href":"/api-reference-v2/api-admin/tracking-api/leads-and-signups"},{"title":"Tracking sales and commissions","description":"Record each non-zero sale for a referred customer so FirstPromoter calculates commissions for the promoter.","openapi":"openapi-v2-tracking POST /sale","href":"/api-reference-v2/api-admin/tracking-api/sales"},{"title":"Tracking refunds and negative commissions","openapi":"openapi-v2-tracking POST /refund","href":"/api-reference-v2/api-admin/tracking-api/refund"},{"title":"Tracking cancellations","openapi":"openapi-v2-tracking POST /cancellation","href":"/api-reference-v2/api-admin/tracking-api/cancellation"}]},{"group":"Referrals","pages":[{"openapi":"openapi-v2-referrals get /referrals","title":"Get available referrals","href":"/api-reference-v2/api-admin/referrals/get-referrals"},{"openapi":"openapi-v2-referrals get /referrals/{id}","title":"Get referral","href":"/api-reference-v2/api-admin/referrals/get-referral"},{"openapi":"openapi-v2-referrals post /referrals","title":"Create referral","href":"/api-reference-v2/api-admin/referrals/create-referral"},{"openapi":"openapi-v2-referrals put /referrals/{id}","title":"Update referral","href":"/api-reference-v2/api-admin/referrals/update-referral"},{"openapi":"openapi-v2-referrals post /referrals/move_to_promoter","title":"Move referrals to promoter","href":"/api-reference-v2/api-admin/referrals/move-referrals-to-promoter"},{"openapi":"openapi-v2-referrals delete /referrals","title":"Delete referrals","href":"/api-reference-v2/api-admin/referrals/delete-referrals"}]},{"group":"Promoters","pages":[{"openapi":"openapi-v2-promoters get /promoters","title":"Get available promoters","href":"/api-reference-v2/api-admin/promoters/get-available-promoters"},{"openapi":"openapi-v2-promoters post /promoters","title":"Create promoter","href":"/api-reference-v2/api-admin/promoters/create-promoter"},{"openapi":"openapi-v2-promoters get /promoters/{id}","title":"Get promoter details","href":"/api-reference-v2/api-admin/promoters/get-promoter-details"},{"openapi":"openapi-v2-promoters put /promoters/{id}","title":"Update promoter","href":"/api-reference-v2/api-admin/promoters/update-promoter"},{"openapi":"openapi-v2-promoters get /promoters/{id}/referral_links","title":"Get promoter referral links","href":"/api-reference-v2/api-admin/promoters/get-promoter-referral-links"},{"openapi":"openapi-v2-promoters get /promoters/{id}/chart_data","title":"Get data used for chart","href":"/api-reference-v2/api-admin/promoters/get-data-used-for-chart"},{"openapi":"openapi-v2-promoters get /promoters/{id}/overview_report","title":"Get reports for promoter overview","href":"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-overview"},{"openapi":"openapi-v2-promoters get /promoters/{id}/traffic_sources_report","title":"Get reports for promoter traffic sources","href":"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-traffic-sources"},{"openapi":"openapi-v2-promoters get /promoters/{id}/urls_report","title":"Get reports for promoter URLs","href":"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls"},{"openapi":"openapi-v2-promoters post /promoters/assign_parent","title":"Assign a parent promoter","href":"/api-reference-v2/api-admin/promoters/assign-parent-promoter"},{"openapi":"openapi-v2-promoters post /promoters/add_to_campaign","title":"Add promoters to campaign","href":"/api-reference-v2/api-admin/promoters/add-promoter-to-campaign"},{"openapi":"openapi-v2-promoters post /promoters/move_to_campaign","title":"Move promoters to campaign","href":"/api-reference-v2/api-admin/promoters/move-promoter-to-campaign"},{"openapi":"openapi-v2-promoters post /promoters/accept","title":"Accept promoters","href":"/api-reference-v2/api-admin/promoters/accept-promoters"},{"openapi":"openapi-v2-promoters post /promoters/reject","title":"Reject promoters","href":"/api-reference-v2/api-admin/promoters/reject-promoters"},{"openapi":"openapi-v2-promoters post /promoters/block","title":"Block promoters","href":"/api-reference-v2/api-admin/promoters/block-promoters"},{"openapi":"openapi-v2-promoters post /promoters/archive","title":"Archive promoters","href":"/api-reference-v2/api-admin/promoters/archive-promoters"},{"openapi":"openapi-v2-promoters post /promoters/restore","title":"Restore promoters","href":"/api-reference-v2/api-admin/promoters/restore-unarchived-promoters"}]},{"group":"Promoter Campaigns","pages":[{"openapi":"openapi-v2-promoter-campaigns get /promoter_campaigns","title":"Get available promoter campaigns","href":"/api-reference-v2/api-admin/promoter-campaigns/get-available-promoter-campaigns"},{"openapi":"openapi-v2-promoter-campaigns put /promoter_campaigns/{id}","title":"Update promoter campaign","href":"/api-reference-v2/api-admin/promoter-campaigns/update-promoter-campaign"}]},{"group":"Commissions","pages":[{"openapi":"openapi-v2-commissions get /commissions","title":"Get all commissions","href":"/api-reference-v2/api-admin/commissions/get-all-commissions"},{"openapi":"openapi-v2-commissions post /commissions","title":"Create a commission","href":"/api-reference-v2/api-admin/commissions/create-a-commission"},{"openapi":"openapi-v2-commissions put /commissions/{id}","title":"Update a commission","href":"/api-reference-v2/api-admin/commissions/update-a-commission"},{"openapi":"openapi-v2-commissions post /commissions/approve","title":"Approve commissions","href":"/api-reference-v2/api-admin/commissions/approve-commissions"},{"openapi":"openapi-v2-commissions post /commissions/deny","title":"Deny commissions","href":"/api-reference-v2/api-admin/commissions/deny-commissions"},{"openapi":"openapi-v2-commissions post /commissions/mark_fulfilled","title":"Mark nonmonetary commissions as fulfilled","href":"/api-reference-v2/api-admin/commissions/mark-nonmonetary-commissions-as-fulfilled"},{"openapi":"openapi-v2-commissions post /commissions/mark_unfulfilled","title":"Mark nonmonetary commissions as unfulfilled","href":"/api-reference-v2/api-admin/commissions/mark-nonmonetary-commissions-as-unfulfilled"}]},{"group":"Promo Codes","pages":[{"openapi":"openapi-v2-promocodes get /promo_codes","title":"Get promo codes","href":"/api-reference-v2/api-admin/promo-codes/get-promo-codes"},{"openapi":"openapi-v2-promocodes get /promo_codes/{id}","title":"Get promo code by id","href":"/api-reference-v2/api-admin/promo-codes/get-promo-code-by-id"},{"openapi":"openapi-v2-promocodes post /promo_codes","title":"Create promo code (Stripe Only)","href":"/api-reference-v2/api-admin/promo-codes/create-promo-code"},{"openapi":"openapi-v2-promocodes put /promo_codes/{id}","title":"Update promo code by id","href":"/api-reference-v2/api-admin/promo-codes/update-promo-code-by-id"},{"openapi":"openapi-v2-promocodes delete /promo_codes/{id}","title":"Archive promo code by id","href":"/api-reference-v2/api-admin/promo-codes/archive-promo-code-by-id"}]},{"group":"Payouts","pages":[{"openapi":"openapi-v2-payouts get /payouts","title":"Get all payouts","href":"/api-reference-v2/api-admin/payouts/get-all-payouts"},{"openapi":"openapi-v2-payouts get /payouts/stats","title":"Get payout stats","href":"/api-reference-v2/api-admin/payouts/get-payout-stats"},{"openapi":"openapi-v2-payouts get /payouts/due_stats","title":"Get due payout stats","href":"/api-reference-v2/api-admin/payouts/get-due-payout-stats"},{"openapi":"openapi-v2-payouts get /payouts/group_by_promoters","title":"Get all payouts grouped by promoters","href":"/api-reference-v2/api-admin/payouts/get-all-payouts-grouped-by-promoters"}]},{"group":"Reports","pages":[{"openapi":"openapi-v2-reports get /reports/campaigns","title":"Get reports for campaigns","href":"/api-reference-v2/api-admin/reports/get-reports-for-campaigns"},{"openapi":"openapi-v2-reports get /reports/overview","title":"Get reports for overview","href":"/api-reference-v2/api-admin/reports/get-reports-for-overview"},{"openapi":"openapi-v2-reports get /reports/promoters","title":"Get reports for promoters","href":"/api-reference-v2/api-admin/reports/get-reports-for-promoters"},{"openapi":"openapi-v2-reports get /reports/urls","title":"Get reports for URLs","href":"/api-reference-v2/api-admin/reports/get-reports-for-urls"},{"openapi":"openapi-v2-reports get /reports/traffic_sources","title":"Get reports for traffic sources","href":"/api-reference-v2/api-admin/reports/get-reports-for-traffic-sources"}]}]},{"tab":"Affiliate API Reference","pages":[{"title":"Affiliate API Reference","href":"/api-reference-v2/api-affiliate/introduction"}]},{"tab":"Advanced API Reference","hidden":true,"pages":[{"title":"Advanced API Reference","href":"/api-reference-v2/api-advanced/introduction"}]}]},{"anchor":"API Reference","icon":"webhook","href":"https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction"},{"anchor":"Help Center","icon":"square-question","href":"https://help.firstpromoter.com/en/"}]},{"version":"v1","pages":[{"title":"v1","href":"/introduction"}]}]},"basePath":"","title":"Tracking leads and sign-ups - FirstPromoter Docs","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BtG4DSkw.js","snippetPresets-C1k1xDhp.js","utils-PMJoEt4Y.js","style-to-object-BY3JEAdk.js","utils-DW3Pr7Jq.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DIISLO2w.js","conditional-requirements-CFM0id0Q.js","cloneDeep-BErNCZCm.js","_Uint8Array-f0PCu9f_.js","isObject-FP1Yky1u.js","ApiExamples-OjY-8mqu.js","usePlaygroundInputsStore-B2HS2hUb.js","shallow-DVFuuIDQ.js","isEqual-DG0UKiQC.js","CodeSnippets-Cy6FBgwN.js","CodeSnippet-D1PtG8ed.js","getApiPlaygroundDisplay-Dkx2eNtL.js","Page-C8Cg25if.js","DynamicMarkdown-BvJIe00T.js","SectionHeading-B0rKYV8d.js","icon-yclzBff4.js","MethodPill-DxA11cCF.js","getPastedJson-CpkIDpMk.js","DuplicateIcon-CFCQNJ-D.js","axios-CsQoIw0U.js","Markdown-CK5C-fmV.js","AssistantPageLink-Cw134Dd-.js","dist-3xM3Qrc7.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}