Skip to main content
POST
/
v1
/
affiliates
curl -X POST "https://api.affonso.io/v1/affiliates" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Smith",
    "email": "[email protected]",
    "program_id": "cm7xutqbb0001yfkcrnpextmp",
    "company_name": "Jane LLC",
    "country_code": "US",
    "payout_method": "paypal",
    "payout_details": {
      "email": "[email protected]"
    }
  }'

{
  "success": true,
  "data": {
    "id": "cmj8q1wau0003sb01lpvka478",
    "name": "Jane Smith",
    "email": "[email protected]",
    "tracking_id": "jane-smith",
    "source": "api",
    "partnership_status": "APPROVED",
    "onboarding_completed": false,
    "program_id": "cm7xutqbb0001yfkcrnpextmp",
    "group_id": null,
    "created_at": "2024-01-25T09:15:00Z"
  }
}

​
Body Parameters

​
name
string
required
The affiliate’s full display name. Must be between 1 and 100 characters.
​
email
string
required
The affiliate’s email address. Must be a valid email format. If a user with this email already exists, they will be linked to the affiliate account.
​
program_id
string
required
Program ID to associate affiliate with.
​
group_id
string
Optional affiliate group ID.
​
company_name
string
Company name for invoice. Maximum 100 characters.
​
country_code
string
2-letter ISO country code.
​
payout_method
string
Payout method (lowercase with underscores). Valid values: paypal, wise, payoneer, paxum, webmoney, skrill, wire_transfer, bitcoin, ethereum, alipay, wechat, manual, none.
​
payout_details
object
Payout details (fields vary by method, all snake_case). The required fields depend on the payout_method:
  • Email-based methods (paypal, wise, payoneer, paxum, skrill): email (string, valid email)
  • ID-based methods (webmoney, alipay, wechat): account_id (string)
  • Crypto methods (bitcoin, ethereum): address (string, wallet address)
  • Wire transfer (wire_transfer): bank_name, account_number, swift_code, iban, routing_number, account_name (all strings)
  • Manual (manual): No details required

​
Response

The response includes the created affiliate object with the following fields:
​
success
boolean
Always true for successful responses
​
data
object
The created affiliate object.
curl -X POST "https://api.affonso.io/v1/affiliates" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Smith",
    "email": "[email protected]",
    "program_id": "cm7xutqbb0001yfkcrnpextmp",
    "company_name": "Jane LLC",
    "country_code": "US",
    "payout_method": "paypal",
    "payout_details": {
      "email": "[email protected]"
    }
  }'

{
  "success": true,
  "data": {
    "id": "cmj8q1wau0003sb01lpvka478",
    "name": "Jane Smith",
    "email": "[email protected]",
    "tracking_id": "jane-smith",
    "source": "api",
    "partnership_status": "APPROVED",
    "onboarding_completed": false,
    "program_id": "cm7xutqbb0001yfkcrnpextmp",
    "group_id": null,
    "created_at": "2024-01-25T09:15:00Z"
  }
}
Note: To retrieve related data like promo codes, commission overrides, invoice details, and payout methods, use GET /v1/affiliates/{id}?expand=promoCodes,commissionOverrides,invoiceDetails,payoutMethod.