Skip to main content
POST
Create an ad campaign

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Optional caller-generated value that prevents duplicate generation when retrying the same request.

Required string length: 1 - 255

Body

application/json
product_id
string<uuid>
required
prompt
string
required

Campaign direction describing the audience, angle, offer, or visual tone.

Required string length: 1 - 2000
language
enum<string>
default:English
Available options:
English,
Hindi,
Hinglish,
Tamil,
Telugu,
Marathi,
Bengali,
Kannada,
Malayalam,
Gujarati,
Punjabi,
Odia,
Assamese,
Urdu,
Spanish,
French,
German,
Portuguese,
Italian,
Dutch,
Russian,
Arabic,
Mandarin Chinese,
Japanese,
Korean,
Vietnamese,
Thai,
Indonesian,
Filipino,
Turkish,
Polish,
Ukrainian,
Greek,
Hebrew,
Swedish,
Norwegian,
Danish,
Finnish,
Romanian,
Czech,
Hungarian,
Swahili
creative_count
enum<integer>
default:10
Available options:
3,
5,
10,
15,
20,
25,
30

Response

Campaign accepted.

id
string<uuid>
required
brand_id
string<uuid>
required
product_id
string<uuid>
required
name
string
required
status
enum<string>
required
Available options:
queued,
in_progress,
completed,
failed,
canceled
requested_creative_count
integer
required
completed_creative_count
integer
required
failed_creative_count
integer
required
creatives
object[]
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
Last modified on August 26, 2026