Skip to main content
POST
/
v1
/
campaigns
curl -X POST "https://api.adrelay.dev/v1/campaigns" \
  -H "X-API-Key: $ADRELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Sale 2026",
    "goal": "CONVERSIONS",
    "budget_amount": 50.00,
    "budget_period": "DAILY",
    "platform": "google_ads"
  }'

{
  "id": "camp_new789",
  "platform": "google_ads",
  "remote_id": "555666777",
  "name": "Summer Sale 2026",
  "status": "PAUSED",
  "goal": "CONVERSIONS",
  "budget_amount": 50.00,
  "budget_period": "DAILY",
  "currency": "USD",
  "created_at": "2026-03-21T10:00:00Z",
  "updated_at": "2026-03-21T10:00:00Z"
}

curl -X POST "https://api.adrelay.dev/v1/campaigns" \
  -H "X-API-Key: $ADRELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Sale 2026",
    "goal": "CONVERSIONS",
    "budget_amount": 50.00,
    "budget_period": "DAILY",
    "platform": "google_ads"
  }'

{
  "id": "camp_new789",
  "platform": "google_ads",
  "remote_id": "555666777",
  "name": "Summer Sale 2026",
  "status": "PAUSED",
  "goal": "CONVERSIONS",
  "budget_amount": 50.00,
  "budget_period": "DAILY",
  "currency": "USD",
  "created_at": "2026-03-21T10:00:00Z",
  "updated_at": "2026-03-21T10:00:00Z"
}
Campaigns are created with a status of PAUSED by default. Use the Update Campaign endpoint to set the status to ACTIVE when ready. For creating campaigns across multiple platforms simultaneously, use the targets array instead of platform. See the Multi-Platform Campaigns guide for details.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
name
string
required
Required string length: 1 - 255
​
budget_amount
number
required
​
budget_period
enum<string>
required
Available options:
DAILY,
MONTHLY,
TOTAL,
LIFETIME
​
goal
enum<string>
required
Available options:
UNSPECIFIED,
BRAND_AWARENESS,
REACH,
WEBSITE_TRAFFIC,
LEADS,
SALES,
APP_PROMOTION
​
targets
object[]
required
Required array length: 1 - 10 elements
​
currency
string
default:USD
​
start_at
string | null
​
end_at
string | null

Response

Campaign created (single-platform) or multi-platform results

​
data
object
required