---
updatedAt: 2026-04-10T09:08:22.000Z
agentTools:
  projectIndex: https://developers.koddi.com/llms.txt
---

# Create Creative

Creates a new creative for an advertiser. Accepts either `application/json` or `multipart/form-data`. Use multipart to upload an image or video file directly to Koddi's CDN.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Creatives",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://koddi.io/console/v1/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/member_groups/{memberGroupId}/advertisers/{advertiserId}/creatives": {
      "post": {
        "summary": "Create Creative",
        "description": "Creates a new creative for an advertiser. Accepts either `application/json` or `multipart/form-data`. Use multipart to upload an image or video file directly to Koddi's CDN.",
        "operationId": "create-creative",
        "tags": [
          "Creatives"
        ],
        "parameters": [
          {
            "name": "memberGroupId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The member group ID (provided by Koddi)"
          },
          {
            "name": "advertiserId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The advertiser ID"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "media_type",
                  "url",
                  "text"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Internal display name for the creative"
                  },
                  "media_type": {
                    "type": "string",
                    "enum": [
                      "image",
                      "video",
                      "audio",
                      "tag",
                      "dynamic",
                      "dooh",
                      "text"
                    ],
                    "description": "Type of media."
                  },
                  "url": {
                    "type": "string",
                    "description": "Landing page click-through URL"
                  },
                  "text": {
                    "type": "string",
                    "description": "Media text content. Pass empty string if not applicable."
                  },
                  "headline": {
                    "type": "string",
                    "description": "Ad headline."
                  },
                  "description": {
                    "type": "string",
                    "description": "Ad description."
                  },
                  "primary_text": {
                    "type": "string",
                    "description": "Primary body text."
                  },
                  "additional_headlines": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 5,
                    "description": "Up to 5 alternate headlines"
                  },
                  "additional_descriptions": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 5,
                    "description": "Up to 5 alternate descriptions"
                  },
                  "additional_primary_texts": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 5,
                    "description": "Up to 5 alternate primary texts"
                  },
                  "additional_text": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 5,
                    "description": "Up to 5 alternate text values"
                  },
                  "tags": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Labels for internal categorization"
                  }
                }
              }
            },
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "file",
                  "body"
                ],
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image or video file to upload"
                  },
                  "body": {
                    "type": "string",
                    "description": "JSON string containing the same fields as the application/json payload"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Creative created",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "creative_id": {
                      "type": "integer"
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                },
                "example": {
                  "status": "success",
                  "result": {
                    "creative_id": 9001,
                    "created_at": "2026-04-09T18:00:00Z"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request — missing required field or invalid value"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Advertiser not found"
          }
        }
      }
    }
  }
}
```