FirstPromoter website screenshot

FirstPromoter

FirstPromoter is an affiliate, referral and influencer marketing platform for SaaS and subscription businesses, run by Igil Web SRL since 2016. It tracks clicks, leads and sales, manages promoters and campaigns, calculates multi-tier commissions and rewards, and pays affiliates through PayPal, Wise, Stripe and managed payouts. The public v2 REST API spans 37 first-party OpenAPI definitions and 179 operations across an admin surface, a promoter-facing surface and a server-side tracking surface, alongside a 44-event webhooks v2 system, a browser tracking library, and a remote MCP server for AI clients.

FirstPromoter publishes 30 APIs on the APIs.io network, including Asset Categories API, Assets API, Batch Processes API, and 27 more. Tagged areas include Affiliate Marketing, Referral Tracking, Software-as-a-Service, Commission Management, and Reward Distribution.

The FirstPromoter catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 1 Spectral governance ruleset.

FirstPromoter’s developer surface includes documentation, API reference, getting-started guide, support, engineering blog, pricing, signup flow, and 82 more developer resources.

61.5/100 strong ▬ flat Agent 41/100 agent ready saas Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0
AccessPaid
74 APIs 1 MCP Servers
Affiliate MarketingReferral TrackingSoftware-as-a-ServiceCommission ManagementReward DistributionPromotersPartner MarketingInfluencer MarketingPayoutsAttributionWebhookMCP

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/firstpromoter: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 30

Individual APIs this provider publishes, each with its own machine-readable definition.

FirstPromoter Asset Categories API

The Asset Categories API from FirstPromoter — 2 operation(s) for asset categories.

FirstPromoter Assets API

The Assets API from FirstPromoter — 4 operation(s) for assets.

FirstPromoter Batch Processes API

The Batch Processes API from FirstPromoter — 3 operation(s) for batch processes.

FirstPromoter Campaigns API

The Campaigns API from FirstPromoter — 2 operation(s) for campaigns.

FirstPromoter Cancellation API

The Cancellation API from FirstPromoter — 1 operation(s) for cancellation.

FirstPromoter Commissions API

The Commissions API from FirstPromoter — 9 operation(s) for commissions.

FirstPromoter Contract Documents API

The Contract Documents API from FirstPromoter — 4 operation(s) for contract documents.

FirstPromoter Contracts API

The Contracts API from FirstPromoter — 2 operation(s) for contracts.

FirstPromoter Custom Referral Statuses API

The Custom Referral Statuses API from FirstPromoter — 3 operation(s) for custom referral statuses.

FirstPromoter Dashboards API

The Dashboards API from FirstPromoter — 4 operation(s) for dashboards.

FirstPromoter Email Settings API

The Email Settings API from FirstPromoter — 2 operation(s) for email settings.

FirstPromoter Emails API

The Emails API from FirstPromoter — 8 operation(s) for emails.

FirstPromoter Invoice Templates API

The Invoice Templates API from FirstPromoter — 3 operation(s) for invoice templates.

FirstPromoter Invoices API

The Invoices API from FirstPromoter — 8 operation(s) for invoices.

FirstPromoter Payments Batches API

The Payments Batches API from FirstPromoter — 2 operation(s) for payments batches.

FirstPromoter Payout Methods API

The Payout Methods API from FirstPromoter — 2 operation(s) for payout methods.

FirstPromoter Payouts API

The Payouts API from FirstPromoter — 10 operation(s) for payouts.

FirstPromoter Products API

The Products API from FirstPromoter — 2 operation(s) for products.

FirstPromoter Promo Codes API

The Promo Codes API from FirstPromoter — 2 operation(s) for promo codes.

FirstPromoter Promoter Campaigns API

The Promoter Campaigns API from FirstPromoter — 5 operation(s) for promoter campaigns.

FirstPromoter Promoters API

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

FirstPromoter Referral Links API

The Referral Links API from FirstPromoter — 2 operation(s) for referral links.

FirstPromoter Referrals API

The Referrals API from FirstPromoter — 8 operation(s) for referrals.

FirstPromoter Refund API

The Refund API from FirstPromoter — 1 operation(s) for refund.

FirstPromoter Reports API

The Reports API from FirstPromoter — 7 operation(s) for reports.

FirstPromoter Rewards API

The Rewards API from FirstPromoter — 3 operation(s) for rewards.

FirstPromoter Sale API

The Sale API from FirstPromoter — 1 operation(s) for sale.

FirstPromoter Signup API

The Signup API from FirstPromoter — 1 operation(s) for signup.

FirstPromoter Webhook Deliveries API

The Webhook Deliveries API from FirstPromoter — 3 operation(s) for webhook deliveries.

FirstPromoter Webhooks API

The Webhooks API from FirstPromoter — 4 operation(s) for webhooks.

Scroll for all 30

Open Collections 38

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

FirstPromoter Assets

OPEN COLLECTION

FirstPromoter API

OPEN COLLECTION

FirstPromoter API

OPEN COLLECTION

FirstPromoter API

OPEN COLLECTION

FirstPromoter API

OPEN COLLECTION

FirstPromoter API

OPEN COLLECTION

FirstPromoter API

OPEN COLLECTION

FirstPromoter API

OPEN COLLECTION

FirstPromoter API

OPEN COLLECTION

FirstPromoter Assets API

OPEN COLLECTION

FirstPromoter Email API

OPEN COLLECTION

FirstPromoter API

OPEN COLLECTION

FirstPromoter API

OPEN COLLECTION

FirstPromoter Admin API

OPEN COLLECTION

FirstPromoter Reports API

OPEN COLLECTION

Scroll for all 38

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

FirstPromoter MCP Server

FirstPromoter ships a first-party remote MCP server at https://mcp.firstpromoter.com. It is an HTTP-transport server behind OAuth 2.1 (authorization code + PKCE S256, RFC 7591 d...

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Firstpromoter Rate Limits

1 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Firstpromoter Context

37 classes · 9 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

FirstPromoter API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

Commission

11 properties

JSON SCHEMA

Promoter

14 properties

JSON SCHEMA

Referral

10 properties

JSON SCHEMA

Examples 3

Example request and response payloads for these APIs.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Firstpromoter Authentication

apiKey/http · 3 schemes

SECURITY

Firstpromoter Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Firstpromoter Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Firstpromoter Agentic Access

84 operations · 51 acting · 1 human-in-the-loop

84 operations · 51 acting

AGENTIC

Resources

Get Started 4

Portal, sign-up, and the first successful call

Documentation 5

Reference material describing how the API behaves

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 10

Pagination, idempotency, versioning, errors, and events

Scroll for all 10

Build 8

SDKs, sample code, and the tooling you integrate with

Scroll for all 8

Access & Security 4

Authentication, authorization, and security posture

Operate 5

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 40

Properties that don't map to a standard resource type

Scroll for all 40

Source (apis.yml)

apis.yml Raw ↑
aid: firstpromoter
name: FirstPromoter
description: FirstPromoter is an affiliate, referral and influencer marketing platform for SaaS and subscription businesses,
  run by Igil Web SRL since 2016. It tracks clicks, leads and sales, manages promoters and campaigns, calculates multi-tier
  commissions and rewards, and pays affiliates through PayPal, Wise, Stripe and managed payouts. The public v2 REST API spans
  37 first-party OpenAPI definitions and 179 operations across an admin surface, a promoter-facing surface and a server-side
  tracking surface, alongside a 44-event webhooks v2 system, a browser tracking library, and a remote MCP server for AI clients.
type: Index
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: paid
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Paid
  confidence: high
  source:
  - plans
  - authentication
  - scopes
  - rate-limits
  - security
  generated: '2026-09-03'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/firstpromoter.png
url: https://raw.githubusercontent.com/api-evangelist/firstpromoter/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-08-13'
specificationVersion: '0.23'
tags:
- Affiliate Marketing
- Referral Tracking
- Software-as-a-Service
- Commission Management
- Reward Distribution
- Promoters
- Partner Marketing
- Influencer Marketing
- Payouts
- Attribution
- Webhook
- MCP
tags_raw:
- Affiliate Marketing
- Referral Tracking
- SaaS
- Commission Management
- Reward Distribution
- Promoters
- Partner Marketing
- Influencer Marketing
- Payouts
- Attribution
- Webhooks
- MCP
apis:
- aid: firstpromoter:firstpromoter-asset-categories-api
  name: FirstPromoter Asset Categories API
  description: The Asset Categories API from FirstPromoter — 2 operation(s) for asset categories.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  baseURL: https://api.firstpromoter.com/api/v2/company
  tags:
  - Asset Categories
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-asset-categories-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  - type: APIReference
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/products-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/contract-documents
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/email-settings
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payout-methods
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referral-links
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/asset-categories-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/campaigns-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contract-documents-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contracts-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/custom-referral-statuses
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/dashboard-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/invoices
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payments-batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/rewards
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/webhooks
  - type: Webhooks
    url: asyncapi/firstpromoter-webhooks.yml
- aid: firstpromoter:firstpromoter-assets-api
  name: FirstPromoter Assets API
  description: The Assets API from FirstPromoter — 4 operation(s) for assets.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  baseURL: https://api.firstpromoter.com/api/v2/company
  tags:
  - Assets
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-assets-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  - type: APIReference
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/products-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/contract-documents
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/email-settings
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payout-methods
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referral-links
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/asset-categories-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/campaigns-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contract-documents-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contracts-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/custom-referral-statuses
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/dashboard-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/invoices
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payments-batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/rewards
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/webhooks
  - type: Webhooks
    url: asyncapi/firstpromoter-webhooks.yml
- aid: firstpromoter:firstpromoter-batch-processes-api
  name: FirstPromoter Batch Processes API
  description: The Batch Processes API from FirstPromoter — 3 operation(s) for batch processes.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  baseURL: https://api.firstpromoter.com/api/v2/company
  tags:
  - Batch Processes
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-batch-processes-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  - type: APIReference
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/products-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/contract-documents
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/email-settings
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payout-methods
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referral-links
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/asset-categories-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/campaigns-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contract-documents-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contracts-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/custom-referral-statuses
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/dashboard-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/invoices
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payments-batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/rewards
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/webhooks
  - type: Webhooks
    url: asyncapi/firstpromoter-webhooks.yml
- aid: firstpromoter:firstpromoter-campaigns-api
  name: FirstPromoter Campaigns API
  description: The Campaigns API from FirstPromoter — 2 operation(s) for campaigns.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  baseURL: https://api.firstpromoter.com/api/v2/company
  tags:
  - Campaigns
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-campaigns-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  - type: APIReference
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/products-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/contract-documents
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/email-settings
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payout-methods
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referral-links
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/asset-categories-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/campaigns-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contract-documents-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contracts-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/custom-referral-statuses
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/dashboard-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/invoices
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payments-batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/rewards
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/webhooks
  - type: Webhooks
    url: asyncapi/firstpromoter-webhooks.yml
- aid: firstpromoter:firstpromoter-cancellation-api
  name: FirstPromoter Cancellation API
  description: The Cancellation API from FirstPromoter — 1 operation(s) for cancellation.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  baseURL: https://api.firstpromoter.com/api/v2/company
  tags:
  - Cancellation
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-cancellation-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  - type: APIReference
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/products-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/contract-documents
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/email-settings
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payout-methods
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referral-links
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/asset-categories-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/campaigns-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contract-documents-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contracts-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/custom-referral-statuses
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/dashboard-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/invoices
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payments-batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/rewards
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/webhooks
  - type: Webhooks
    url: asyncapi/firstpromoter-webhooks.yml
- aid: firstpromoter:firstpromoter-commissions-api
  name: FirstPromoter Commissions API
  description: The Commissions API from FirstPromoter — 9 operation(s) for commissions.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  baseURL: https://api.firstpromoter.com/api/v2/company
  tags:
  - Commissions
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-commissions-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  - type: APIReference
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/products-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/contract-documents
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/email-settings
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payout-methods
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referral-links
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/asset-categories-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/campaigns-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contract-documents-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contracts-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/custom-referral-statuses
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/dashboard-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/invoices
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payments-batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/rewards
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/webhooks
  - type: Webhooks
    url: asyncapi/firstpromoter-webhooks.yml
- aid: firstpromoter:firstpromoter-contract-documents-api
  name: FirstPromoter Contract Documents API
  description: The Contract Documents API from FirstPromoter — 4 operation(s) for contract documents.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  baseURL: https://api.firstpromoter.com/api/v2/company
  tags:
  - Contract Documents
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-contract-documents-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payout-methods-api
  - type: APIReference
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/products-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/contract-documents
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/email-settings
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payout-methods
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referral-links
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-affiliate/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/asset-categories-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/assets
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/campaigns-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/commissions
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contract-documents-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/contracts-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/custom-referral-statuses
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/dashboard-api
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/invoices
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/payments-batches
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/payouts
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promo-codes
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoter-campaigns
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/referrals
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/reports
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-advanced/rewards
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/tracking-api
  - type: Documentation
    url: https://

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

Work with this as data

Every provider 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 providers

9 MCP tools reach this
  • find_providersBrowse and filter every provider in the catalog.
  • get_provider_artifactsEvery artifact this provider publishes, grouped by type.
  • get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
  • get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
  • get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
  • get_provider_ratingPRO — composite, band, trend and facet scores.
  • 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 provider
curl "https://apis.io/api/v1/providers/firstpromoter"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/firstpromoter/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/firstpromoter/evidence"

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.

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