Home/HighLevel/Features/Marketing/HighLevel Affiliate Manager public API: overview and setup

Marketing

HighLevel Affiliate Manager public API: overview and setup

In short

The Affiliate Manager Public API lets developers programmatically manage a location’s affiliate program, adding affiliates, handling campaigns, tracking commissions and payouts, validating referral IDs, and managing payout methods, without using the UI. It is part of the v3 API catalog for custom integrations.

AreaMarketing · Getting Started with Affiliate Manager
Used forSaaS startup, Digital marketing agency, Ecommerce store
Setup steps4 steps in 1 task
Last updatedNovember 17, 2026

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

  1. Open the Affiliate Manager API v3 documentation in the HighLevel Developer Marketplace.
  2. Create a new app or open an existing one in the marketplace and enable the required read and/or write scopes.
  3. Authorize the app for a specific location using OAuth 2.0 with Location Access.
  4. 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

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

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.

Get More InformationOpens on HighLevelPublished November 3, 2026 · Updated November 17, 2026

Common questions

Common questions about Affiliate Manager Public API.

Do I need an app in the Developer Marketplace to use these APIs?

Yes. The API uses OAuth 2.0 with Location Access, so your integration must be authorized for the location whose affiliate data you want to access.

Where can I find request and response examples?

Examples are included in the Affiliate Manager section of the HighLevel API documentation, with a separate reference page for each endpoint group.

What happens if I try to create an affiliate with an email that already exists?

The Create Affiliate endpoint updates the existing affiliate record instead of creating a duplicate entry.

Can an affiliate have more than one payout method?

An affiliate may have one PayPal and one bank payout method. The first method added becomes the primary method.

Do referral IDs need to be unique?

Referral IDs must be unique within the location, even if affiliates belong to different campaigns.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.