FirstPromoter Promoters API

The Promoters API from FirstPromoter — 16 operation(s) for promoters.

Documentation GitHub OpenAPI

Operations 18

GET /promoters/current Get current promoter #

GET /promoters/sub_affiliates Get current promoter sub affiliates #

GET /promoters/chart_data Get chart data #

GET /promoters/email_from_encrypted_id Get the promoter email #

PUT /promoters/set_password Set the user password #

POST /promoters/archive Archives current promoter #

GET /promoters Get available promoters #

POST /promoters Create promoter #

GET /promoters/{id} Get promoter details #

PUT /promoters/{id} Update promoter #

GET /promoters/{id}/chart_data Get data used for chart #

POST /promoters/accept Accept promoters #

POST /promoters/reject Reject promoters #

POST /promoters/block Block promoters #

POST /promoters/move_to_campaign Move promoters to campaign #

POST /promoters/add_to_campaign Add promoters to campaign #

POST /promoters/assign_parent Assign a parent promoter #

POST /promoters/restore Restore promoters #

Documentation

https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api

https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction

https://docs.firstpromoter.com/api-reference-v2/api-advanced/products-api

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/assets

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/campaigns

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/commissions

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/contract-documents

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/email-settings

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payout-methods

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payouts

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promo-codes

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoter-campaigns

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoters

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referral-links

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referrals

https://docs.firstpromoter.com/api-reference-v2/api-affiliate/reports

https://docs.firstpromoter.com/api-reference-v2/api-advanced/asset-categories-api

https://docs.firstpromoter.com/api-reference-v2/api-advanced/assets

https://docs.firstpromoter.com/api-reference-v2/api-admin/batches

https://docs.firstpromoter.com/api-reference-v2/api-advanced/campaigns-api

https://docs.firstpromoter.com/api-reference-v2/api-admin/commissions

https://docs.firstpromoter.com/api-reference-v2/api-advanced/contract-documents-api

https://docs.firstpromoter.com/api-reference-v2/api-advanced/contracts-api

https://docs.firstpromoter.com/api-reference-v2/api-advanced/custom-referral-statuses

https://docs.firstpromoter.com/api-reference-v2/api-advanced/dashboard-api

https://docs.firstpromoter.com/api-reference-v2/api-admin

https://docs.firstpromoter.com/api-reference-v2/api-advanced/invoices

https://docs.firstpromoter.com/api-reference-v2/api-advanced/payments-batches

https://docs.firstpromoter.com/api-reference-v2/api-admin/payouts

https://docs.firstpromoter.com/api-reference-v2/api-admin/promo-codes

https://docs.firstpromoter.com/api-reference-v2/api-admin/promoter-campaigns

https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters

https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals

https://docs.firstpromoter.com/api-reference-v2/api-admin/reports

https://docs.firstpromoter.com/api-reference-v2/api-advanced/rewards

https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api

https://docs.firstpromoter.com/api-reference-v2/api-admin/webhooks

Specifications

https://raw.githubusercontent.com/api-evangelist/firstpromoter/refs/heads/main/openapi/firstpromoter-promoters-api-openapi.yml

Other Resources

https://raw.githubusercontent.com/api-evangelist/firstpromoter/refs/heads/main/asyncapi/firstpromoter-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/firstpromoter-promoters-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Firstpromoter Promoters API
  version: '1.0'
  description: 'Operations tagged Promoters across 2 of this provider''s published API definitions: firstpromoter-v2-affiliate-promoters-openapi.yml, firstpromoter-v2-promoters-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.firstpromoter.com/api/v2/affiliate
- url: https://api.firstpromoter.com/api/v2/company
security:
- BearerAuth: []
tags:


# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/firstpromoter/refs/heads/main/openapi/firstpromoter-promoters-api-openapi.yml