Back to Blog

Building Custom Affiliate Integrations with the PartnerForge API

Building Custom Integrations with the PartnerForge API

The PartnerForge API gives you programmatic access to your affiliate program data. Build custom dashboards, automate workflows, or integrate affiliate data into your existing tools.

Authentication

All API requests require an API key passed in the Authorization header:

Authorization: Bearer pf_your_api_key_here

Generate API keys in your dashboard under Settings > API Keys. Keys are scoped to your account and can be revoked at any time.

Core Endpoints

Programs

GET /api/programs — List your programs

POST /api/programs — Create a program

PUT /api/programs/:id — Update a program

Affiliates

GET /api/programs/:id/affiliates — List affiliates for a program

POST /api/programs/:id/affiliates/:affiliateId/approve — Approve an applicant

DELETE /api/programs/:id/affiliates/:affiliateId — Remove an affiliate

Clicks and Conversions

GET /api/clicks — List clicks with filters

GET /api/conversions — List conversions with filters

GET /api/commissions — List commissions with filters

Reports

GET /api/reports/daily — Daily aggregated stats

GET /api/reports/affiliates — Per-affiliate performance

Webhook Events

PartnerForge sends webhook notifications for key events. Configure webhook URLs in your dashboard.

Supported events:

  • affiliate.applied — New affiliate application
  • affiliate.approved — Affiliate approved
  • click.created — New referral click tracked
  • conversion.created — New conversion tracked
  • commission.created — Commission generated
  • commission.approved — Commission approved for payout
  • commission.paid — Commission paid out
  • payout.completed — Payout batch completed
  • fraud.detected — Fraud signal detected
  • program.updated — Program settings changed

All webhooks are HMAC-signed for security and automatically retried on failure (1 minute, 5 minutes, 30 minutes).

Rate Limits

  • 100 requests per minute per API key
  • Bulk endpoints available for high-volume operations

SDKs and Libraries

We provide official libraries for common languages:

  • JavaScript/Node.js
  • Python
  • PHP
  • Ruby

All available via package managers and documented in our developer docs.

Get your API key and start building custom integrations.

Ready to launch your affiliate program?

Get Started Free