Create Creative

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"
  }
}

POST

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"
  }
}

Getting Started

Guide

Core Resources

Program Management

Marketplace

Body Parameters

Response

​Body Parameters

​Response

Body Parameters

Response