--- title: 10.2 Leads via API description: Leads via API --- [Skip to content](https://support.track360.io/knowledge-base/10.2-leads-via-api#main-content) [Customer Portal](https://support.track360.io/customer-portal?hsLang=en) ![Track360 High-Res Logo (no backround)-1](https://support.track360.io/hs-fs/hubfs/Track360%20High-Res%20Logo%20(no%20backround)-1.png?width=200&height=35&name=Track360%20High-Res%20Logo%20(no%20backround)-1.png) Open main navigation Close main navigation - - [Customer Portal](https://support.track360.io/customer-portal) - [Contact us](https://support.track360.io/customer-portal/new) [Contact us](https://support.track360.io/customer-portal/new?hsLang=en) How can we help you? - There are no suggestions because the search field is empty. 1. [Track360 - Platform Guide](https://support.track360.io/knowledge-base?hsLang=en) 2. [SECTION 10: INTEGRATIONS](https://support.track360.io/knowledge-base/section-10-integrations?hsLang=en) 3. [Integrations Introduction](https://support.track360.io/knowledge-base/section-10-integrations?hsLang=en#integrations-introduction) # 10.2 Leads via API - API feature allows two systems to communicate and exchange data automatically, without manual input. - Types of API tools in Track360: - **Leads via API**: Affiliates send potential customers data (leads) directly into the CRM through Track360. - **API Reports**: External systems can fetch real-time reports and performance data from Track360.   The functionality of **Leads via API** needs to be available and configured by your **tech provider**. Please check if the integration exists. - Activation of Product’s API integration allows to receive **Leads via API**: - Track360 connects to the CRM to create Leads. - The affiliate connects to Track360 the Leads. - The affiliate is sending Leads to the CRM through Track360. - Navigate into **Advertisers & Products \> Products** ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FtzXJ1f3hutkcwQNSCLha%252Fimage.png%3Falt%3Dmedia%26token%3D876d25ec-5bdd-47f4-a8d6-33a4b6821446&width=768&dpr=4&quality=100&sign=ee120aa6&sv=2) - Check if the product shows API Integration icon - If the **product displays the API Integration icon**, you can activate the Leads via API for the selected affiliate/IBs. - If the **product does not display the API Integration icon**, you need to contact Track360 Support Team Members to set it up. **Set API Integration on an Affiliate/IB** - Navigate into **Affiliate Management \> Manage** - Select the affiliate or click to the arrow icon on the rightmost of the row. Click on the **Open Affiliate Page** ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FWhJhxsvA3RPLkUDAKJny%252Fimage.png%3Falt%3Dmedia%26token%3D0b56ab42-5ec7-4e0d-bf8d-f9927d7a3e99&width=768&dpr=4&quality=100&sign=9bd0a71c&sv=2) - Navigate into **API tab** to add API Integration or view the existing ones. ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FK5THzVIcAlXYXtHcdmrL%252Fimage.png%3Falt%3Dmedia%26token%3Db35747c4-2eab-4181-9754-a065b4dfd137&width=768&dpr=4&quality=100&sign=c78348e2&sv=2)   API Token Permission dropdown is not needed to set something up for Leads via API. - **API Integrations** dropdown provides integration API options for each product already configured, such as Leads or Account Registration APIs. - Select the desired API and click **Add** to enable integration. ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FKRgtudrCxCYuOw7RQUBo%252Fimage.png%3Falt%3Dmedia%26token%3D77969897-caa0-45dc-a88f-b031d9259774&width=768&dpr=4&quality=100&sign=bc548407&sv=2) - Once you added, the integrated API will be listed under **Existing API Integrations** - Use the **Delete** button, to delete the integration of the API for the selected Affiliate/IB - Use the **Edit** button to configure the API access for the particular affiliate/IB. To edit Existing API Integration for the affiliate/IB, refer to [subsection of API on 2.6 Open Affiliate Page](https://track360.gitbook.io/track360/section-2-partner-management/editor/2.6-open-affiliate-page#api-tab)   ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252Fzui6235K80DLwZ1XpAQI%252Fimage.png%3Falt%3Dmedia%26token%3Dd593bf1e-e0fe-4cf7-ab28-d6a30490e081&width=768&dpr=4&quality=100&sign=5df298e4&sv=2) - **API Key** gives you the unique token for API integration. - To generate the key, click the Plus button and copy the **token API** value - To renew the key, click the **Extend Expiry Date** button to update its validity. ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FW25RtC5nlBwGYoX6LKhl%252Fimage.png%3Falt%3Dmedia%26token%3D40fafa89-d592-4b7f-b52f-e0d08f778ebd&width=768&dpr=4&quality=100&sign=de36a861&sv=2)   The API Key is sensitive information. Share it only with the corresponding affiliate/IB and never expose it publicly.   - **Whitelisted IPs** to secure API access. Define the **From** and **To** fields to define a range of IP addresses or add a single IP. Then, click **Add** to save the IP(s) to the whitelist. - To allow the *full API range*, set the minimum (0.0.0.0) and maximum (255.255.255.255). Only set full range if you really want open access. - Additionally, find previously added IP ranges in the list with a trashcan icon to delete unwanted entries. ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FdPEvzP7b0LrI1MjzsqpZ%252Fimage.png%3Falt%3Dmedia%26token%3Dbb2a7e93-5b34-4c85-8b66-a463caee3dcd&width=768&dpr=4&quality=100&sign=eac7c251&sv=2) - Once all API details are configured. Copy the **API Key** value to provide it to the affiliate/IB. **Testing API** - The **API testing Integration** helps verify that Leads are correctly sent to the Affiliate/IB’s CRM.   Testing will only work for affiliates/IBs that have been properly configured and have an API Token generated. To **set up API integratio**n for an affiliate/IB, refer to[10.2 Set API Integration](https://track360.gitbook.io/track360/section-10-integrations/editor/10.2-leads-via-api#set-api-integration-on-an-affiliate-ib) on an Affiliate/IB - Navigate into **Advertisers & Products \> Products.** - Click on the **Edit** action (pencil icon), on the rightmost side of the row, of the desired Product. ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FvI86197BpPkBroKN7va5%252Fimage.png%3Falt%3Dmedia%26token%3D73cb1b4c-ef32-4419-9a70-8be6c299d7e1&width=768&dpr=4&quality=100&sign=d1b96dee&sv=2) - On **APIs input/output** tab, where each row determines an already configured Integration, select the action **Click here to test the API** on the desired one to test. ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252Fs23vPPZNe1UcTtA6TQRY%252Fimage.png%3Falt%3Dmedia%26token%3D987a22df-e143-4e2d-acb0-c3b2f2d7ec60&width=768&dpr=4&quality=100&sign=e7988f18&sv=2) - Choose an already configured affiliate/IB with API Permissions, and select a campaign. The API Token will be automatically filled up.   If the API Token does not fill up it is necessary to go into Affiliate/IB’s Open Page and set the API Authentication. To generate it refer to[10.2 Set API Integration on an Affiliate/IB](https://track360.gitbook.io/track360/section-10-integrations/editor/10.2-leads-via-api#set-api-integration-on-an-affiliate-ib)   ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FTdHi96yfHcS2b9lJvfMR%252Fimage.png%3Falt%3Dmedia%26token%3D2adbd1de-3707-4f7b-99be-bb7c36d691b7&width=768&dpr=4&quality=100&sign=a0fb65d0&sv=2) - Fill up the Lead Information details. - There are two ways for **testing**, - Testing as a manager, choosing the desired affiliate/IB. [Test on Track360.](https://track360.gitbook.io/track360/section-10-integrations/editor/10.2-leads-via-api#test-on-track360) - Testing as an affiliate/IB, using the JSON body. [Test on Postman](https://track360.gitbook.io/track360/section-10-integrations/editor/10.2-leads-via-api#test-on-postman). **Test on Track360** - Once Integration is selected to **test** - Fill up the Lead Information details.     Need to select an affiliate/IB which has already configured Leads via API, whitelist IP and API Token. To generate it refer to [10.2 Set API Integration on an Affiliate/IB.](https://track360.gitbook.io/track360/section-10-integrations/editor/10.2-leads-via-api#set-api-integration-on-an-affiliate-ib) ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FphEIG693b6HgIIPhATAc%252Fimage.png%3Falt%3Dmedia%26token%3D0fc3792c-cb27-4e11-b2e6-176594b4baaf&width=768&dpr=4&quality=100&sign=a5bae4f5&sv=2) - Click **test** to check the API operation - Detailed summary of the API test will be displayed, where: - The left panel displays the full **HTTP Request body**, showing all parameters sent in the test (e.g., email, IP, product ID, campaign ID). - The right panel shows the **HTTP Response**, including status code, response message, and any error returned by the affiliate's API. ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FSn5SZ4qAZsG3W3zYv6ra%252Fimage.png%3Falt%3Dmedia%26token%3D0d93b6e7-de00-4dcd-a02d-b499542a358b&width=768&dpr=4&quality=100&sign=96c6c3e6&sv=2) - Once tested, navigate into **Reports \> Leads via API**. Run a report and review if a new row was generated with the Lead test. ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252Fw1PE3gzUv60xxiIkuADZ%252Fimage.png%3Falt%3Dmedia%26token%3D8c477329-43f1-430a-b8c6-05caa9c04230&width=768&dpr=4&quality=100&sign=c88aad09&sv=2) - Check information of Lead test as: affiliate id, campaign, country, email, name or any tracking parameter. - Also, check on the Affiliate/IB’s CRM the test was created as a Lead Test on Postman - With Postman the affiliate/IBs do not need extra permissions to test API Integration. - The affiliate/IB will be able to quickly adjust lead details on the json body and easily track errors or response details for testing purposes. - Provide to the related affiliate/IB the corresponding information: - **Post URL**: send the URL using the dns configured plus the described content. Following as [https://tracking.brandname.com/webapi/api/affiliatemanagement/CreateAffiliateAPI](https://tracking.brandname.com/webapi/api/affiliatemanagement/CreateAffiliateAPI) - **API Token and JSON Body**: copied from the test window, clicking on **View as JSON button** (explained below)   Be careful as this information is very sensitive data. *The API token is an authentication value unique and private for the corresponding affiliate/IB/employee.*   - Once Integration is selected to **test.** - Fill up the Lead Information details. ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FMmguuuSGh327KDgb66Ih%252Fimage.png%3Falt%3Dmedia%26token%3D39584320-2ea5-4063-9657-76a7f337a7cb&width=768&dpr=4&quality=100&sign=25da16d4&sv=2) - Click **View as JSON** to copy the API body clicking on **Copy JSON to Clipboard** (this JSON view will be useful needed for the affiliate to test) ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FF3jRNymxFuN5BB6B1QD1%252Fimage.png%3Falt%3Dmedia%26token%3D7e03af8d-5a3a-4005-938d-5b98b181ef4f&width=768&dpr=4&quality=100&sign=59fe1dbb&sv=2) - On **Postman**, the affiliate/IB will select **POST as Method** and enter the Post URL. [https://tracking.brandname.com/webapi/api/affiliatemanagement/CreateAffiliateAPI](https://tracking.brandname.com/webapi/api/affiliatemanagement/CreateAffiliateAPI) - On the **Headers tab** fill up: - **Key**: Content-type - **Value**: application/json ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FuLnU7T4u8py4UXtutWj4%252Fimage.png%3Falt%3Dmedia%26token%3De71a7f09-6af6-49f9-b6b6-726ce465c6df&width=768&dpr=4&quality=100&sign=dbfec8df&sv=2) - On the **Body tab**, as raw and JSON type, paste JSON body of Test API integration of the platform. ![](https://track360.gitbook.io/track360/~gitbook/image?url=https%3A%2F%2F4110691288-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1iHXZgeTSXZwHDnWa5S8%252Fuploads%252FYz2nAvEQHhQpkkxbm8JK%252Fimage.png%3Falt%3Dmedia%26token%3Dff90d879-4973-40b3-b7b7-4767cdd29631&width=768&dpr=4&quality=100&sign=5d381571&sv=2) - Test the API clicking on **Send** and analyse and share the result.     **Response text, success example**: { "success": true, "autoLoginUrl": "//www.affprogram.com/session/signin/?email=affiliateEmail@email.com&loginToken=fe961199-c3db-4dae-990a-a745522a0a8d" } **Response text, failure example**: **Success** { "success": false, "error": "username already exist" } To follow up the leads results, when they became a customer (such a SignUp or FTD), you can: Set postbacks: Navigate into subsection Pixels/Postbacks, on Open Affiliate Page to set up postbacks to the affiliate/IB, follow up explanation on section [10.1 Postback/Pixel Integration](https://track360.gitbook.io/track360/section-10-integrations/editor/10.1-postbacks-pixels-integration) Leads via API Reports: Logged in as the desired affiliate/IB, navigate into section [10.3 Leads via API Reports](https://track360.gitbook.io/track360/section-10-integrations/editor/10.3-reports-via-api)to manage all APIs created under their performance.   - [SECTION 1: GETTING STARTED WITH TRACK360](https://support.track360.io/knowledge-base/section-1-getting-started-with-track360?hsLang=en#main-content) - [What is Track360?](https://support.track360.io/knowledge-base/section-1-getting-started-with-track360?hsLang=en#what-is-track360) - [SECTION 2: PARTNER MANAGEMENT](https://support.track360.io/knowledge-base/section-2-partner-management?hsLang=en#main-content) - [Affiliate Management Introduction](https://support.track360.io/knowledge-base/section-2-partner-management?hsLang=en#affiliate-management-introduction) - [SECTION 3: SETTING UP DEALS](https://support.track360.io/knowledge-base/section-3-setting-up-deals?hsLang=en#main-content) - [Deals Introduction](https://support.track360.io/knowledge-base/section-3-setting-up-deals?hsLang=en#deals-introduction) - [SECTION 4: REPORTS & ANALYTICS](https://support.track360.io/knowledge-base/section-4-reports-analytics?hsLang=en#main-content) - [Reports Introduction](https://support.track360.io/knowledge-base/section-4-reports-analytics?hsLang=en#reports-introduction) - [SECTION 5: SETTINGS](https://support.track360.io/knowledge-base/section-5-settings?hsLang=en#main-content) - [Organization Settings Introduction](https://support.track360.io/knowledge-base/section-5-settings?hsLang=en#organization-settings-introduction) - [Brand Introduction](https://support.track360.io/knowledge-base/section-5-settings?hsLang=en#brand-introduction) - [Configuration Settings Introduction](https://support.track360.io/knowledge-base/section-5-settings?hsLang=en#configuration-settings-introduction) - [Advertising & Product Introduction](https://support.track360.io/knowledge-base/section-5-settings?hsLang=en#advertising-product-introduction) - [Translation Introduction](https://support.track360.io/knowledge-base/section-5-settings?hsLang=en#translation-introduction) - [DNS Introduction](https://support.track360.io/knowledge-base/section-5-settings?hsLang=en#dns-introduction) - [SECTION 6: MARKETING TOOLS](https://support.track360.io/knowledge-base/section-6-marketing-tools?hsLang=en#main-content) - [Marketing Tools Introduction](https://support.track360.io/knowledge-base/section-6-marketing-tools?hsLang=en#marketing-tools-introduction) - [SECTION 7: COMPLIANCE](https://support.track360.io/knowledge-base/section-7-compliance?hsLang=en#main-content) - [Compliance Introduction](https://support.track360.io/knowledge-base/section-7-compliance?hsLang=en#compliance-introduction) - [SECTION 8: EMAILS & EVENTS MANAGEMENT](https://support.track360.io/knowledge-base/section-8-emails-events-management?hsLang=en#main-content) - [Email Communication Introduction](https://support.track360.io/knowledge-base/section-8-emails-events-management?hsLang=en#email-communication-introduction) - [Event Notifications Management Introduction](https://support.track360.io/knowledge-base/section-8-emails-events-management?hsLang=en#event-notifications-management-introduction) - [SECTION 9: FINANCE & PAYOUTS](https://support.track360.io/knowledge-base/section-9-finance-payouts?hsLang=en#main-content) - [Finance Introduction](https://support.track360.io/knowledge-base/section-9-finance-payouts?hsLang=en#finance-introduction) - [SECTION 10: INTEGRATIONS](https://support.track360.io/knowledge-base/section-10-integrations?hsLang=en#main-content) - [Integrations Introduction](https://support.track360.io/knowledge-base/section-10-integrations?hsLang=en#integrations-introduction) [![Track360 High-Res Logo (no backround)](https://support.track360.io/hs-fs/hubfs/Track360%20High-Res%20Logo%20(no%20backround).png?width=150&height=26&name=Track360%20High-Res%20Logo%20(no%20backround).png "Track360 High-Res Logo (no backround)")](http://Track360.io) Copyright © 2025, Track360