FirstPromoter website screenshot

FirstPromoter

Affiliate and referral tracking platform for SaaS companies with a REST API for managing promoters, tracking referrals, and handling reward distribution.

FirstPromoter publishes 12 APIs on the APIs.io network, including Commissions API, Company API, Emails API, and 9 more. Tagged areas include Affiliate Marketing, Referral Tracking, SaaS, Commission Management, and Reward Distribution.

The FirstPromoter catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

FirstPromoter’s developer surface includes authentication, documentation, engineering blog, pricing, and 11 more developer resources.

🌐 Visit website 📡 Source on GitHub
50.5/100 developing ▬ flat Agent 41/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessPaidSelf serve
12 APIs
Affiliate MarketingReferral TrackingSaaSCommission ManagementReward DistributionPromoters

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 50.5/100 · developing
Contract Quality 18.0 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 3.4 / 13
Governance 8.3 / 12
Discoverability 6.5 / 10
Agent readiness — 41/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. 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. Want it done for you? Prioritized profiling — $2,500 →

APIs 12

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

FirstPromoter Commissions API

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

FirstPromoter Company API

The Company API from FirstPromoter — 11 operation(s) for company.

FirstPromoter Emails API

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

FirstPromoter Payouts API

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

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 — 11 operation(s) for promoters.

FirstPromoter Referrals API

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

FirstPromoter Reports API

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

FirstPromoter Track API

The Track API from FirstPromoter — 4 operation(s) for track.

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 12

Pricing Plans 1

Published pricing tiers and plan structures.

Firstpromoter Plans Pricing

3 plans

PLANS

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.

Firstpromoter Finops

FINOPS

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.

Firstpromoter Create Promoter Example

3 fields

EXAMPLE

Firstpromoter Track Sale Example

3 fields

EXAMPLE

Firstpromoter Webhook Event Example

4 fields

EXAMPLE

Security Posture 2

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

Firstpromoter Authentication

http · 1 scheme

SECURITY

Firstpromoter Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

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

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Vocabulary
Vocabulary
 JSONLDContext
JSONLDContext

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrg
GitHubOrg

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 1

Status, limits, changes, and where to get help

RateLimits
RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 Plans
Plans
 FinOps
FinOps

Company 3

The organization behind the API

Website
Website
 LinkedIn
LinkedIn
 Blog
Blog

Other 1

Properties that don't map to a standard resource type

X
X

Source (apis.yml)

apis.yml Raw ↑ 
aid: firstpromoter
name: FirstPromoter
description: Affiliate and referral tracking platform for SaaS companies with a REST API for managing promoters, tracking
  referrals, and handling reward distribution.
type: Index
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  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-06-13'
specificationVersion: '0.19'
tags:
- Affiliate Marketing
- Referral Tracking
- SaaS
- Commission Management
- Reward Distribution
- Promoters
apis:
- aid: firstpromoter:firstpromoter-commissions-api
  name: FirstPromoter Commissions API
  description: The Commissions API from FirstPromoter — 8 operation(s) for commissions.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Commissions
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-commissions-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-company-api
  name: FirstPromoter Company API
  description: The Company API from FirstPromoter — 11 operation(s) for company.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Company
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-company-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-emails-api
  name: FirstPromoter Emails API
  description: The Emails API from FirstPromoter — 8 operation(s) for emails.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Emails
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-emails-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-payouts-api
  name: FirstPromoter Payouts API
  description: The Payouts API from FirstPromoter — 1 operation(s) for payouts.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Payouts
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-payouts-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-promo-codes-api
  name: FirstPromoter Promo Codes API
  description: The Promo Codes API from FirstPromoter — 2 operation(s) for promo codes.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Promo Codes
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-promo-codes-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-promoter-campaigns-api
  name: FirstPromoter Promoter Campaigns API
  description: The Promoter Campaigns API from FirstPromoter — 5 operation(s) for promoter campaigns.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Promoter Campaigns
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-promoter-campaigns-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-promoters-api
  name: FirstPromoter Promoters API
  description: The Promoters API from FirstPromoter — 11 operation(s) for promoters.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Promoters
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-promoters-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-referrals-api
  name: FirstPromoter Referrals API
  description: The Referrals API from FirstPromoter — 7 operation(s) for referrals.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Referrals
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-referrals-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-reports-api
  name: FirstPromoter Reports API
  description: The Reports API from FirstPromoter — 6 operation(s) for reports.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Reports
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-reports-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-track-api
  name: FirstPromoter Track API
  description: The Track API from FirstPromoter — 4 operation(s) for track.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Track
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-track-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-webhook-deliveries-api
  name: FirstPromoter Webhook Deliveries API
  description: The Webhook Deliveries API from FirstPromoter — 3 operation(s) for webhook deliveries.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Webhook Deliveries
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-webhook-deliveries-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
- aid: firstpromoter:firstpromoter-webhooks-api
  name: FirstPromoter Webhooks API
  description: The Webhooks API from FirstPromoter — 4 operation(s) for webhooks.
  humanURL: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  baseURL: https://api.firstpromoter.com/api/v2
  tags:
  - Webhooks
  properties:
  - type: OpenAPI
    url: openapi/firstpromoter-webhooks-api-openapi.yml
  - type: Documentation
    url: https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction
  - type: JSONSchema
    url: json-schema/firstpromoter-promoter-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-referral-schema.json
  - type: JSONSchema
    url: json-schema/firstpromoter-commission-schema.json
  - type: Examples
    url: examples/firstpromoter-create-promoter-example.json
  - type: Examples
    url: examples/firstpromoter-track-sale-example.json
  - type: Examples
    url: examples/firstpromoter-webhook-event-example.json
common:
- type: AgenticAccess
  url: agentic-access/firstpromoter-agentic-access.yml
- type: DomainSecurity
  url: security/firstpromoter-domain-security.yml
- type: Authentication
  url: authentication/firstpromoter-authentication.yml
- type: Vocabulary
  url: vocabulary/firstpromoter-vocabulary.yml
- type: JSONLDContext
  url: json-ld/firstpromoter-context.jsonld
- type: Website
  url: https://firstpromoter.com/
- type: Documentation
  url: https://docs.firstpromoter.com/
- type: GitHubOrg
  url: https://github.com/firstpromoter
- type: LinkedIn
  url: https://www.linkedin.com/company/first-promoter
- type: Blog
  url: https://firstpromoter.com/blog
- type: Pricing
  url: https://firstpromoter.com/pricing
- type: X
  url: https://x.com/firstpromoter
- type: Plans
  url: plans/firstpromoter-plans-pricing.yml
- type: RateLimits
  url: rate-limits/firstpromoter-rate-limits.yml
- type: FinOps
  url: finops/firstpromoter-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com