Creatives

A creative is the visual and copy content used in an ad - the image, headline, body text, and destination URL. Creatives are stored in a library scoped to an advertiser and must be explicitly associated with an ad group before they appear in a campaign.

Workflow summary:

Create a creative and upload the image to Koddi's content delivery network
Associate the creative with one or more ad groups

🔔
Approval: Depending on your account configuration, creatives may enter a Pending state and require approval before going live. Once approved, the status changes to Active.

Creating a Creative

Use multipart/form-data to upload the image and set the creative metadata in a single request. The file field carries the image; the body field carries the creative fields as a JSON string. Koddi stores the image on its content delivery network and attaches the resulting URL to the creative automatically.

See API Reference for full request and response schemas.

Meta (Facebook/Instagram) Ad Requirements

When creating creatives for Meta campaigns, the following fields are required by Meta:

Field	Description
`url`	Click-through destination URL for the ad
`headline`	Short title displayed on the ad (max ~40 chars recommended)
`primary_text`	Body copy displayed above the ad image (max ~125 chars recommended)
`description`	Additional description line below the headline

Meta Image requirements and best practices:

Associating Creatives with Ad Groups

A creative must be associated with an ad group before it will be used in a campaign. An ad group can have multiple creatives, and a creative can be associated with multiple ad groups.

Use the List Eligible Creatives endpoint to verify which of your creatives meet the media spec for a given experience before associating.

See Code Samples for a full end-to-end example.