Skip to main content
POST
/
v1
/
program
/
groups
curl -X POST "https://api.affonso.io/v1/program/groups" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Premium Partners",
    "description": "High-performing affiliates with higher commissions",
    "custom_website_url": "https://partners.acme.com"
  }'
{
  "success": true,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Premium Partners",
    "description": "High-performing affiliates with higher commissions",
    "custom_website_url": "https://partners.acme.com",
    "is_default": false,
    "created_at": "2024-06-15T14:30:00.000Z"
  }
}
Create a new affiliate group. The number of groups is limited by your plan tier:
PlanGroup Limit
Launch3
Growth5
EliteUnlimited
EnterpriseUnlimited

Body Parameters

name
string
required
Group name. Must be between 1 and 255 characters.
description
string | null
Group description. Set to null or omit for no description.
custom_website_url
string | null
Custom website URL for this group. Must be a valid URL. Set to null or omit to use default.
is_default
boolean
default:"false"
Set as the default group for new affiliates.

Response

Returns the created group object (HTTP 201).
curl -X POST "https://api.affonso.io/v1/program/groups" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Premium Partners",
    "description": "High-performing affiliates with higher commissions",
    "custom_website_url": "https://partners.acme.com"
  }'
{
  "success": true,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Premium Partners",
    "description": "High-performing affiliates with higher commissions",
    "custom_website_url": "https://partners.acme.com",
    "is_default": false,
    "created_at": "2024-06-15T14:30:00.000Z"
  }
}