Skip to main content
POST
/
v1
/
campaigns
Create campaign
curl --request POST \
  --url https://api-sandbox.y.uno/v1/campaigns \
  --header 'Content-Type: application/json' \
  --header 'account-code: <api-key>' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "name": "Summer Sale 2026",
  "description": "Summer promotional campaign",
  "start_date": "2026-06-01T00:00:00.000Z",
  "end_date": "2026-08-31T23:59:59.999Z",
  "country": "BR"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "status": "ACTIVE",
  "start_date": "2023-11-07T05:31:56Z",
  "end_date": "2023-11-07T05:31:56Z",
  "country": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
Creates a new campaign. If no status is provided, campaigns default to INACTIVE. See the campaign object reference for more information.

Authorizations

​
public-api-key
string
header
required

Your public API key from the Yuno Dashboard

​
private-secret-key
string
header
required

Your private secret key (server-side only)

​
account-code
string
header
required

Your account identifier. The alias X-Account-Code is also accepted.

Body

application/json
​
name
string
required

Campaign name

​
start_date
string<date-time>
required

Campaign start date

​
end_date
string<date-time>
required

Campaign end date

​
country
string
required

ISO 3166-1 alpha-2 country code

​
description
string

Campaign description

Response

Campaign created

​
id
string<uuid>
​
name
string
​
description
string
​
status
enum<string>
Available options:
ACTIVE,
INACTIVE,
DRAFT,
EXPIRED
​
start_date
string<date-time>
​
end_date
string<date-time>
​
country
string
​
created_at
string<date-time>
​
updated_at
string<date-time>