01Who this is for
- Developers building partner apps, because they can create and update affiliates directly via API.
- Agencies that run affiliate programs for multiple clients, as the API lets them sync data and automate reporting.
- Finance teams that need commission and payout details, because the API provides raw data for reconciliation.
02Affiliate Manager Public API, explained
The Affiliate Manager Public API offers REST endpoints that cover affiliates, campaigns, customers, commissions, payouts, payout methods, and media assets. Each endpoint group lets you create, read, update, or delete records without opening the platform UI. The API lives in the v3 API catalog on the HighLevel Developer Marketplace.
Requests follow standard OAuth 2.0 with Location Access. Two scopes control access: a read only scope for data retrieval endpoints and a write scope for creation, updates, or deletions. After authorizing a location, you call the endpoint group that matches the data you need, such as Affiliates or Payout Methods.
The API also enforces specific behaviors: duplicate affiliate emails update existing records, omitted fields clear on update, referral IDs must be unique per location, and payout method rules limit one PayPal and one bank method per affiliate.
03How businesses use Affiliate Manager Public API
- SaaS startup. The startup calls the Create Affiliate endpoint to onboard new partners from its own signup form, then uses the List Commissions endpoint to pull earnings data into its internal dashboard for each partner.
- Digital marketing agency. The agency uses the List Customers endpoint to retrieve every lead an affiliate referred, then validates and creates leads via the Create Customer endpoint to integrate with its lead management system.
- Ecommerce store. The store fetches payout method details with the List Payout Methods endpoint, updates bank information through the Update Payout Method endpoint, and reads payout summaries via the List Payouts endpoint for accounting.
04The numbers and rules that matter
- 28 new endpoints and 4 existing endpoints were tightened, for 32 endpoints in total.
- Endpoints are organized into seven groups: Affiliates (10), Payout Methods (6), Commissions (5), Customers (5), Affiliate Media (3), Campaigns (2), Payouts (1).
- Affiliate manager.readonly scope is required for the 12 read only endpoints.
- Affiliate manager.write scope is required for the 20 write endpoints.
05Before you start
- A registered app must exist in the HighLevel Developer Marketplace.
- OAuth 2.0 with Location Access must be configured for the app.
06How to set up and use Affiliate Manager Public API in HighLevel
Get started with Affiliate Manager API
- Open the Affiliate Manager API v3 documentation in the HighLevel Developer Marketplace.
- Create a new app or open an existing one in the marketplace and enable the required read and/or write scopes.
- Authorize the app for a specific location using OAuth 2.0 with Location Access.
- Call the endpoint group that matches your integration need.
07Settings that matter
- affiliate manager.readonly. Grants permission to use the twelve endpoints that only retrieve data.
- affiliate manager.write. Allows access to the twenty endpoints that create, update, or delete data.
08Things to know before you rely on it
- When an affiliate email already exists, the create endpoint updates the existing record instead of adding a duplicate.
- The update endpoint overwrites the affiliate record; any fields omitted in the request are cleared.
- Referral IDs must be unique across all affiliates in the same location, even across different campaigns.
- Suspending an affiliate cancels their pending and denied payouts, commissions, and transactions; reinstating restores them to pending.
- An affiliate can have only one PayPal and one bank payout method; the first method added becomes the primary method.
- The primary payout method cannot be deleted if the affiliate has more than one method attached.
- Bank account numbers returned by the List Payout Methods endpoint show only the last four digits.
09How it connects to the rest of HighLevel
- Learn how the Affiliate Manager works within campaign setups Affiliate manager overview
- Explore guidelines for running multiple affiliate campaigns Multiple campaigns
- Review common affiliate marketing terminology used by HighLevel Affiliate glossary
Michael's take

Be aware that the Affiliate Manager API will overwrite any fields you omit when you send an update request. That behavior can unintentionally clear data if you’re not sending the full record.
When you need to move affiliate data into your own tools, the API gives you complete control. You can automate onboarding, keep finance systems in sync, and build dashboards that show exactly what matters to your clients.