curl -X POST "https://api.affonso.io/v1/program/creatives" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Sale Banner",
"category": "banner",
"subcategory": "leaderboard",
"url": "https://cdn.acme.com/banners/summer-728x90.png",
"tags": ["summer", "sale"],
"dimensions": { "width": 728, "height": 90 },
"usage_notes": "Use on blog sidebars and headers"
}'
{
"success": true,
"data": {
"id": "creative_abc123",
"name": "Summer Sale Banner",
"description": null,
"category": "banner",
"subcategory": "leaderboard",
"url": "https://cdn.acme.com/banners/summer-728x90.png",
"content": null,
"tags": ["summer", "sale"],
"dimensions": { "width": 728, "height": 90 },
"usage_notes": "Use on blog sidebars and headers",
"restrictions": null,
"created_at": "2024-06-15T14:30:00.000Z",
"updated_at": "2024-06-15T14:30:00.000Z"
}
}
Creatives
Create Creative
Create a new creative asset for your program
POST
/
v1
/
program
/
creatives
curl -X POST "https://api.affonso.io/v1/program/creatives" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Sale Banner",
"category": "banner",
"subcategory": "leaderboard",
"url": "https://cdn.acme.com/banners/summer-728x90.png",
"tags": ["summer", "sale"],
"dimensions": { "width": 728, "height": 90 },
"usage_notes": "Use on blog sidebars and headers"
}'
{
"success": true,
"data": {
"id": "creative_abc123",
"name": "Summer Sale Banner",
"description": null,
"category": "banner",
"subcategory": "leaderboard",
"url": "https://cdn.acme.com/banners/summer-728x90.png",
"content": null,
"tags": ["summer", "sale"],
"dimensions": { "width": 728, "height": 90 },
"usage_notes": "Use on blog sidebars and headers",
"restrictions": null,
"created_at": "2024-06-15T14:30:00.000Z",
"updated_at": "2024-06-15T14:30:00.000Z"
}
}
Create a new creative asset (banner, logo, video, etc.) for your affiliate program.
Body Parameters
string | null
Creative name. Maximum 255 characters.
string | null
Creative description.
string | null
Creative category. Valid values:
brand, banner, product, content, video, document.string | null
Creative subcategory (e.g.
leaderboard, skyscraper).string | null
Asset URL. Must be a valid URL.
string | null
HTML or text content (for text-based creatives).
array
Tags for categorization. Array of strings.
object | null
Asset dimensions in pixels. Object with
width (integer) and height (integer).string | null
Usage instructions for affiliates.
string | null
Usage restrictions.
Response
Returns the created creative object (HTTP 201). Same structure as items in the List Creatives response.curl -X POST "https://api.affonso.io/v1/program/creatives" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Sale Banner",
"category": "banner",
"subcategory": "leaderboard",
"url": "https://cdn.acme.com/banners/summer-728x90.png",
"tags": ["summer", "sale"],
"dimensions": { "width": 728, "height": 90 },
"usage_notes": "Use on blog sidebars and headers"
}'
{
"success": true,
"data": {
"id": "creative_abc123",
"name": "Summer Sale Banner",
"description": null,
"category": "banner",
"subcategory": "leaderboard",
"url": "https://cdn.acme.com/banners/summer-728x90.png",
"content": null,
"tags": ["summer", "sale"],
"dimensions": { "width": 728, "height": 90 },
"usage_notes": "Use on blog sidebars and headers",
"restrictions": null,
"created_at": "2024-06-15T14:30:00.000Z",
"updated_at": "2024-06-15T14:30:00.000Z"
}
}
Was this page helpful?