Apply to the program
⚠️ Important — this route is only useful if you have toggled "Require affiliate applications" on for your program. That toggle is what sets the application of newly created affiliates to
not_applied, giving them something to apply with. If the toggle is off, affiliates created throughPOST /api/program/affiliateare instantlyapproved— they have no application to submit, and this route answers 400 "Already approved".
Submits an application for merchant review. The merchant accepts or declines it from the dashboard, which updates the affiliate's status.
Your API key acts as you — the program owner — so this request submits the application on the affiliate's behalf (typically when onboarding them into your own platform). The affiliate must have accepted the current legal terms (enforced at creation for API-created affiliates).
Body
| Field | Type | Required | Notes |
|---|---|---|---|
| fullName | string | yes | ≤ 100 characters. |
| description | string | yes | ≤ 500 characters. How the affiliate plans to promote. |
| promotionMethod | string | yes | One of: website_blog, youtube, tiktok, instagram, x_twitter, newsletter_email, paid_advertising, community_forum. |
Responses
200 — { "success": true } — the affiliate's status becomes pending.
Errors — all { "error": "<message>" }:
| Status | error values |
|---|---|
| 400 | This affiliate has already been approved. · Application already submitted · Please provide your full name. · Please describe how you plan to promote the program (up to 500 characters). · Please choose how you will promote the program. · Invalid application payload · Add an email address to your account before applying to this program. |
| 403 | The affiliate must accept the current affiliate legal terms. |
| 404 | Affiliate not found |
