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
Promoter campaign ID, you can obtain this for each promoter from the promoters endpoint. It is the id that pairs a promoter to a campaign. Not the campaign id.
Sets or clears the fraud check flag on the referral.
no_suspicion — clears the flag and marks the referral as manually reviewed. Once cleared this way, automatic fraud detection will not re-flag the referral.
same_ip_suspicion — flags the referral because it shares an IP address with the promoter.
same_promoter_email — flags the referral because its email matches the promoter's email.
ad_source — flags the referral because it arrived via a paid ad click.
You cannot set the same value that is already set unless the referral was previously cleared with no_suspicion.
Update the commission split for this referral. Pass an array of split partners and their percentages to add or replace splits. Pass an empty array ([]) to remove all splits. The primary promoter automatically receives the remainder of the commission after all split percentages are applied. The sum of all percentages must not exceed 100.
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.
Fraud check (suspicion) status of the referral. no_suspicion means the referral is clean or was manually cleared. same_ip_suspicion means the referral shares an IP with the promoter. same_promoter_email means the referral email matches the promoter email. ad_source means the referral arrived via a paid ad click.
The commission split configuration for this referral. Each entry represents a split partner. The primary promoter (the referral owner) receives the remainder of the commission after all split percentages are applied.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FirstPromoter Docs","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"}},"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":""},"chroma":{"liveDeploymentHistoryId":"6ad5d6664613fdc88740d8e9","collectionId":"8fbb5c1e-fc55-4dd1-8162-6bca9be88e0f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad5d6664613fdc88740d8e9"},"entitlements":{},"buildId":"6ad5d6664613fdc88740d8e9","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Documentation","count":209},{"language":"default","tag":"API Reference","count":81},{"language":"default","tag":"Integration Options","count":39},{"language":"default","tag":"Promoters","count":25},{"language":"default","tag":"Platform","count":22},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Reports","count":8},{"language":"default","tag":"Custom","count":8},{"language":"default","tag":"Payouts","count":7},{"language":"default","tag":"Commissions","count":7}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference-v2/api-admin/referrals/update-referral","slug":"/api-reference-v2/api-admin/referrals/update-referral","pageMetadata":{"openapi":"openapi-v2-referrals put /referrals/{id}","title":"Update referral","description":"Update a specific referral. The id can be a referral ID, email, uid, or username when used with the find_by parameter in the request body. \n \u003cTip>**HTTP Request** \u003cbr/>`PUT https://api.firstpromoter.com/api/v2/company/referrals/{id}`\u003c/Tip>","href":"/api-reference-v2/api-admin/referrals/update-referral"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n }, {Tip} = _components;\n if (!Tip) _missingMdxReference(\"Tip\", true);\n return _jsxs(_components.p, {\n children: [\"Update a specific referral. The id can be a referral ID, email, uid, or username when used with the find_by parameter in the request body.\\n\", _jsxs(Tip, {\n children: [_jsx(_components.strong, {\n children: \"HTTP Request\"\n }), \" \", _jsx(\"br\", {}), _jsx(_components.code, {\n children: \"PUT https://api.firstpromoter.com/api/v2/company/referrals/{id}\"\n })]\n })]\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};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"openapi-v2-referrals put /referrals/{id}","title":"Update referral","description":"Update a specific referral. The id can be a referral ID, email, uid, or username when used with the find_by parameter in the request body. \n \u003cTip>**HTTP Request** \u003cbr/>`PUT https://api.firstpromoter.com/api/v2/company/referrals/{id}`\u003c/Tip>","href":"/api-reference-v2/api-admin/referrals/update-referral"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/firstpromoter/8ad42af542d542c7/downloadables/fpr-prox.js"],"openApiReferenceData":{"operation":{"summary":"Update referral","description":"Update a specific referral. The id can be a referral ID, email, uid, or username when used with the find_by parameter in the request body. \n \u003cTip>**HTTP Request** \u003cbr/>`PUT https://api.firstpromoter.com/api/v2/company/referrals/{id}`\u003c/Tip>","tags":["Referrals"],"parameters":["479b5fa1-b6ce-45a3-9227-4e853df20338","f35e8c62-71c8-4dcd-a5b8-d8fc68954883"],"requestBody":"bcf694a0-e321-4e14-8b05-d02086b3f2b8","responses":{"200":"51aa3c00-f1b2-4b33-ba59-5b44f07ee0a3","401":"797306de-c141-4b18-ad6e-18246ba666e5","403":"4cd005ec-a694-4ccd-bb17-762388f0dc5e","404":"a6f3ed9d-bc7e-42cd-b87b-4de8553c9323"},"method":"put","type":"path","servers":["ac87d9a9-9c04-4105-b282-5a8446996153"],"security":["d11ac46b-5fd2-43c8-baa4-9088fb1b82a5"],"path":"/referrals/{id}","baseUrlOptions":["https://api.firstpromoter.com/api/v2/company"],"title":"Update referral","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"479b5fa1-b6ce-45a3-9227-4e853df20338":{"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"}},"f35e8c62-71c8-4dcd-a5b8-d8fc68954883":{"in":"path","name":"id","required":true,"schema":{"type":"string","isRequired":true,"description":"ID of the referral","uniqueKey":"","typeLabel":"string"},"description":"ID of the referral"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"Email address of the referral, this is required if the uid is null","uniqueKey":"email","typeLabel":"string\u003cemail>"},"uid":{"type":"string","description":"UID of the referral, this is required if the email is null","uniqueKey":"uid","typeLabel":"string"},"username":{"type":"string","description":"Username of the referral. \n\n **Note**: Reach out to us on support if you need this. It needs to be enabled before you can use it.","uniqueKey":"username","typeLabel":"string"},"promoter_campaign_id":{"type":"integer","description":"Promoter campaign ID, you can obtain this for each promoter from the promoters endpoint. It is the id that pairs a promoter to a campaign. Not the campaign id.","uniqueKey":"promoter_campaign_id","typeLabel":"integer"},"find_by":{"type":"string","enum":["email","uid","username"],"description":"Find by attribute. Required when id parameter is an email, uid, or username instead of an ID.\n\n Your request should follow the format `https://api.firstpromoter.com/api/v2/company/referrals/{email or uid or username}`","uniqueKey":"find_by","typeLabel":"enum\u003cstring>"},"fraud_check":{"type":"string","enum":["no_suspicion","same_ip_suspicion","same_promoter_email","ad_source"],"description":"Sets or clears the fraud check flag on the referral.\n\n- **`no_suspicion`** — clears the flag and marks the referral as manually reviewed. Once cleared this way, automatic fraud detection will not re-flag the referral.\n- **`same_ip_suspicion`** — flags the referral because it shares an IP address with the promoter.\n- **`same_promoter_email`** — flags the referral because its email matches the promoter's email.\n- **`ad_source`** — flags the referral because it arrived via a paid ad click.\n\nYou cannot set the same value that is already set unless the referral was previously cleared with `no_suspicion`.","uniqueKey":"fraud_check","typeLabel":"enum\u003cstring>"},"split_details":{"type":"array","description":"Update the commission split for this referral. Pass an array of split partners and their percentages to add or replace splits. Pass an empty array (`[]`) to remove all splits. The primary promoter automatically receives the remainder of the commission after all split percentages are applied. The sum of all percentages must not exceed 100.","items":{"type":"object","required":["promoter_campaign_id","percentage"],"properties":{"promoter_campaign_id":{"type":"integer","description":"The ID of the split partner's campaign enrollment (`promoter_campaign.id`). This is the ID that links a specific promoter to a specific campaign — not the campaign ID itself.","isRequired":true,"uniqueKey":"split_details.items.[INDEX].promoter_campaign_id","typeLabel":"integer"},"percentage":{"type":"integer","description":"The percentage of each commission this promoter receives. Must be between 0 and 100. The sum across all split entries must not exceed 100.","isRequired":true,"uniqueKey":"split_details.items.[INDEX].percentage","typeLabel":"integer"}},"uniqueKey":"split_details.items.[INDEX]","typeLabel":"object"},"example":[{"promoter_campaign_id":1002,"percentage":25},{"promoter_campaign_id":1003,"percentage":30}],"uniqueKey":"split_details","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"email":"jsmith@example.com","uid":"\u003cstring>","username":"\u003cstring>","promoter_campaign_id":123,"split_details":[{"promoter_campaign_id":1002,"percentage":25},{"promoter_campaign_id":1003,"percentage":30}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"51aa3c00-f1b2-4b33-ba59-5b44f07ee0a3":{"description":"Referral updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Id of the referral","uniqueKey":"id","typeLabel":"integer"},"email":{"type":"string","format":"email","description":"Email address of the referral","uniqueKey":"email","typeLabel":"string\u003cemail>"},"uid":{"type":"string","description":"uid of the referral","uniqueKey":"uid","typeLabel":"string"},"state":{"type":"string","enum":["subscribed","signup","active","cancelled","refunded","denied","pending","moved"],"description":"State of the referral","uniqueKey":"state","typeLabel":"enum\u003cstring>"},"metadata":{"type":"object","description":"Additional metadata of the referral","uniqueKey":"metadata","typeLabel":"object"},"entry_source":{"type":"string","enum":["api","coupon","cookie","manual_admin","manual_affiliate"],"description":"Entry source of the referral. This shows where the referral was captured from. \n **Cookie** is set if the referral was captured using the tid cookie, \n **Coupon** is for when the referral is captured via a coupon code. \n**Manual admin** is for when the referral is added manually by an admin. \n**Manual affiliate** is for when the referral is added manually by an affiliate.","uniqueKey":"entry_source","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","description":"Date and time when the referral was created","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"customer_since":{"oneOf":[{"type":"string","format":"date-time","description":"Date and time when the referral became a customer","uniqueKey":"customer_since.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Date and time when the referral became a customer","uniqueKey":"customer_since.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_since","typeLabel":"string\u003cdate-time> | null"},"promoter_campaign":{"type":"object","properties":{"id":{"type":"integer","description":"Id of the promoter campaign","uniqueKey":"promoter_campaign.id","typeLabel":"integer"},"campaign_id":{"type":"integer","description":"Id of the campaign","uniqueKey":"promoter_campaign.campaign_id","typeLabel":"integer"},"promoter_id":{"type":"integer","description":"Id of the promoter","uniqueKey":"promoter_campaign.promoter_id","typeLabel":"integer"},"created_at":{"type":"string","format":"date-time","description":"Date and time when the promoter campaign was created","uniqueKey":"promoter_campaign.created_at","typeLabel":"string\u003cdate-time>"},"promoter":{"type":"object","properties":{"id":{"type":"integer","description":"Id of the promoter","uniqueKey":"promoter_campaign.promoter.id","typeLabel":"integer"},"email":{"type":"string","format":"email","description":"Email address of the promoter","uniqueKey":"promoter_campaign.promoter.email","typeLabel":"string\u003cemail>"},"name":{"type":"string","description":"Name of the promoter","uniqueKey":"promoter_campaign.promoter.name","typeLabel":"string"}},"uniqueKey":"promoter_campaign.promoter","typeLabel":"object"},"campaign":{"type":"object","properties":{"id":{"type":"integer","description":"Id of the campaign","uniqueKey":"promoter_campaign.campaign.id","typeLabel":"integer"},"name":{"type":"string","description":"Name of the campaign","uniqueKey":"promoter_campaign.campaign.name","typeLabel":"string"},"color":{"oneOf":[{"type":"string","description":"Color assigned to the campaign","uniqueKey":"promoter_campaign.campaign.color.oneOf.0","typeLabel":"string"},{"type":"null","description":"Color assigned to the campaign","uniqueKey":"promoter_campaign.campaign.color.oneOf.1","typeLabel":"null"}],"uniqueKey":"promoter_campaign.campaign.color","typeLabel":"string | null"}},"uniqueKey":"promoter_campaign.campaign","typeLabel":"object"}},"uniqueKey":"promoter_campaign","typeLabel":"object"},"fraud_check":{"type":"string","enum":["no_suspicion","same_ip_suspicion","same_promoter_email","ad_source"],"description":"Fraud check (suspicion) status of the referral. `no_suspicion` means the referral is clean or was manually cleared. `same_ip_suspicion` means the referral shares an IP with the promoter. `same_promoter_email` means the referral email matches the promoter email. `ad_source` means the referral arrived via a paid ad click.","uniqueKey":"fraud_check","typeLabel":"enum\u003cstring>"},"created_by_user_email":{"oneOf":[{"type":"string","format":"email","description":"Email address of the user who created the referral","uniqueKey":"created_by_user_email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","description":"Email address of the user who created the referral","uniqueKey":"created_by_user_email.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_by_user_email","typeLabel":"string\u003cemail> | null"},"username":{"oneOf":[{"type":"string","description":"Username chosen by the referral","uniqueKey":"username.oneOf.0","typeLabel":"string"},{"type":"null","description":"Username chosen by the referral","uniqueKey":"username.oneOf.1","typeLabel":"null"}],"uniqueKey":"username","typeLabel":"string | null"},"split_details":{"oneOf":[{"type":"array","description":"The commission split configuration for this referral. Each entry represents a split partner. The primary promoter (the referral owner) receives the remainder of the commission after all split percentages are applied.","items":{"type":"object","properties":{"promoter_campaign_id":{"type":"integer","description":"The ID of the split partner's campaign enrollment","uniqueKey":"split_details.oneOf.0.items.[INDEX].promoter_campaign_id","typeLabel":"integer"},"promoter_id":{"type":"integer","description":"The ID of the split partner (promoter)","uniqueKey":"split_details.oneOf.0.items.[INDEX].promoter_id","typeLabel":"integer"},"percentage":{"type":"integer","description":"The percentage of each commission this promoter receives","uniqueKey":"split_details.oneOf.0.items.[INDEX].percentage","typeLabel":"integer"}},"uniqueKey":"split_details.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"split_details.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"The commission split configuration for this referral. Each entry represents a split partner. The primary promoter (the referral owner) receives the remainder of the commission after all split percentages are applied.","items":{"type":"object","properties":{"promoter_campaign_id":{"type":"integer","description":"The ID of the split partner's campaign enrollment"},"promoter_id":{"type":"integer","description":"The ID of the split partner (promoter)"},"percentage":{"type":"integer","description":"The percentage of each commission this promoter receives"}}},"uniqueKey":"split_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"split_details","typeLabel":"object[] | null"},"first_name":{"oneOf":[{"type":"string","uniqueKey":"first_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"first_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","uniqueKey":"last_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"last_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_name","typeLabel":"string | null"},"website":{"oneOf":[{"type":"string","uniqueKey":"website.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"website.oneOf.1","typeLabel":"null"}],"uniqueKey":"website","typeLabel":"string | null"},"comment":{"oneOf":[{"type":"string","description":"Internal note or comment on this referral","uniqueKey":"comment.oneOf.0","typeLabel":"string"},{"type":"null","description":"Internal note or comment on this referral","uniqueKey":"comment.oneOf.1","typeLabel":"null"}],"uniqueKey":"comment","typeLabel":"string | null"},"is_expired":{"type":"boolean","description":"Whether the referral has expired","uniqueKey":"is_expired","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":123,"email":"jsmith@example.com","uid":"\u003cstring>","state":"subscribed","metadata":{},"entry_source":"api","created_at":"2023-11-07T05:31:56Z","customer_since":"2023-11-07T05:31:56Z","promoter_campaign":{"id":123,"campaign_id":123,"promoter_id":123,"created_at":"2023-11-07T05:31:56Z","promoter":{"id":123,"email":"jsmith@example.com","name":"\u003cstring>"},"campaign":{"id":123,"name":"\u003cstring>","color":"\u003cstring>"}},"fraud_check":"no_suspicion","created_by_user_email":"jsmith@example.com","username":"\u003cstring>","split_details":[{"promoter_campaign_id":123,"promoter_id":123,"percentage":123}],"first_name":"\u003cstring>","last_name":"\u003cstring>","website":"\u003cstring>","comment":"\u003cstring>","is_expired":true}}},"exampleType":"generated"}},"exampleType":"generated"},"797306de-c141-4b18-ad6e-18246ba666e5":{"description":"Unauthorized — the Bearer access token is missing, invalid, expired, or revoked. No JSON response body is returned.","content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"example":{},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"examples"}},"exampleType":"examples"},"4cd005ec-a694-4ccd-bb17-762388f0dc5e":{"description":"Forbidden","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a6f3ed9d-bc7e-42cd-b87b-4de8553c9323":{"description":"Not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"d11ac46b-5fd2-43c8-baa4-9088fb1b82a5":{"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 → Manage API Keys","scopes":[]}}},"servers":{"ac87d9a9-9c04-4105-b282-5a8446996153":{"url":"https://api.firstpromoter.com/api/v2/company","description":"Production server"}},"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 → Manage API Keys","scopes":[]},"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 → Manage API Keys","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference-v2/api-admin/referrals/openapi-v2-referrals.json"},"subdomain":"firstpromoter","siteName":"FirstPromoter Docs","title":"Update referral - FirstPromoter Docs","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference-v2/api-admin/referrals/update-referral","matchLevel":0},"v1":{"href":"/introduction","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2025-09-24T16:23:41.426Z","originalFileLocation":"api-reference-v2/api-admin/referrals/update-referral.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=\"Update a specific referral. The id can be a referral ID, email, uid, or username when used with the find_by parameter in the request body. HTTP Request PUT https://api.firstpromoter.com/api/v2/company/referrals/{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=\"Update referral - FirstPromoter Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Update a specific referral. The id can be a referral ID, email, uid, or username when used with the find_by parameter in the request body. HTTP Request PUT https://api.firstpromoter.com/api/v2/company/referrals/{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/referrals/update-referral\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://firstpromoter.mintlify.app/_mintlify/api/og/v2?division=Referrals\u0026amp;title=Update+referral\u0026amp;description=Update+a+specific+referral.+The+id+can+be+a+referral+ID%2C+email%2C+uid%2C+or+username+when+used+with+the+find_by+parameter+in+the+request+body.+%0A+%3CTip%3E**HTTP+Request\u0026amp;theme=6c5c6938239eba73fb25a5bd\u0026amp;signature=f92b244d06fc641252e6fa69c6c8bc5b0444b61fd1f6991590f9e49343fcef07\">\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=\"Update referral - FirstPromoter Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Update a specific referral. The id can be a referral ID, email, uid, or username when used with the find_by parameter in the request body. HTTP Request PUT https://api.firstpromoter.com/api/v2/company/referrals/{id}\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://firstpromoter.mintlify.app/_mintlify/api/og/v2?division=Referrals\u0026amp;title=Update+referral\u0026amp;description=Update+a+specific+referral.+The+id+can+be+a+referral+ID%2C+email%2C+uid%2C+or+username+when+used+with+the+find_by+parameter+in+the+request+body.+%0A+%3CTip%3E**HTTP+Request\u0026amp;theme=6c5c6938239eba73fb25a5bd\u0026amp;signature=f92b244d06fc641252e6fa69c6c8bc5b0444b61fd1f6991590f9e49343fcef07\">\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/referrals/update-referral\">\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/referrals/update-referral.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/referrals/update-referral#webpage\",\"url\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals/update-referral\",\"name\":\"Update referral\",\"description\":\"Update a specific referral. The id can be a referral ID, email, uid, or username when used with the find_by parameter in the request body. HTTP Request PUT https://api.firstpromoter.com/api/v2/company/referrals/{id}\",\"dateModified\":\"2025-09-24T16:23:41.426Z\",\"isPartOf\":{\"@id\":\"https://docs.firstpromoter.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals/update-referral#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals/update-referral#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Referrals\",\"item\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals/get-referrals\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update referral\",\"item\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals/update-referral\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals/update-referral#apireference\",\"headline\":\"Update referral\",\"name\":\"Update referral\",\"description\":\"Update a specific referral. The id can be a referral ID, email, uid, or username when used with the find_by parameter in the request body. HTTP Request PUT https://api.firstpromoter.com/api/v2/company/referrals/{id}\",\"url\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals/update-referral\",\"mainEntityOfPage\":{\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals/update-referral#webpage\"},\"dateModified\":\"2025-09-24T16:23:41.426Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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":"Introduction","href":"/api-reference-v2/api-admin/introduction"},{"title":"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"},{"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","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","description":"Get a specific referral \n \u003cTip>**HTTP Request** \u003cbr/>`GET https://api.firstpromoter.com/api/v2/company/referrals/{id}`\u003c/Tip>","href":"/api-reference-v2/api-admin/referrals/get-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","description":"With this endpoint you can move referrals to another promoter. \n \u003cNote>If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped`\u003c/Note> \n \u003cTip>**HTTP Request** \u003cbr/>`POST https://api.firstpromoter.com/api/v2/company/referrals/move_to_promoter`\u003c/Tip>","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","hidden":true,"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"}]}]},"title":"Update referral - FirstPromoter Docs","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}