---
title: "Create Campaign"
method: POST
path: "/api/v1/campaigns"
tags: ["Campaigns"]
---

# Create Campaign

`POST /api/v1/campaigns`

## Request

- Base URL: `https://api.adrex.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.adrex.ai/api/v1/campaigns`
- Auth: none declared

Create a new campaign

## Request body

- CampaignCreate
  - `name` string
  - `google_name` string, nullable
  - `meta_name` string, nullable
  - `description` string, nullable
  - `platform` string, required
  - `objective` string, nullable
  - `budget_type` string, nullable
  - `budget_amount` number, nullable
  - `google_budget` number, nullable
  - `meta_budget` number, nullable
  - `currency` string
  - `start_date` string, nullable
  - `end_date` string, nullable
  - `target_audience` TargetAudience
    - `age_min` integer, nullable
    - `age_max` integer, nullable
    - `gender` string, nullable
    - `interests` string[], nullable
  - `target_locations` object[], nullable
  - `target_keywords` string[], nullable
  - `channel_type` string, nullable
  - `bidding_strategy` string, nullable
  - `special_ad_category` string, nullable
  - `target_cpa` number, nullable
  - `target_roas` number, nullable
  - `target_countries` string[], nullable
  - `target_age_min` integer, nullable
  - `target_age_max` integer, nullable
  - `target_genders` string[], nullable
  - `client_id` integer, nullable
  - `google_customer_id` string, nullable
  - `meta_account_id` string, nullable
  - `campaign_type` string, nullable
  - `is_cbo` boolean, nullable
  - `bid_strategy` string, nullable
  - `meta_campaign_id` string, nullable
  - `status` string, nullable
  - `meta_status` string, nullable

## Response `201`

Successful Response

- CampaignResponse
  - `id` integer, required
  - `name` string, required
  - `description` string, nullable
  - `platform` string, required
  - `status` string, nullable
  - `google_status` string, nullable
  - `meta_status` string, nullable
  - `objective` string, nullable
  - `budget_type` string, nullable
  - `budget_amount` number, nullable
  - `google_budget` number, nullable
  - `meta_budget` number, nullable
  - `currency` string
  - `start_date` string, nullable
  - `end_date` string, nullable
  - `target_audience` object, nullable
  - `target_locations` unknown[], nullable
    - unknown
  - `target_keywords` unknown[], nullable
    - unknown
  - `google_customer_id` string, nullable
  - `meta_account_id` string, nullable
  - `google_campaign_id` string, nullable
  - `meta_campaign_id` string, nullable
  - `client_id` integer, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/adrex/apis/adrex-ai.md) · [All operations](https://skmtc.dev/adrex/apis/adrex-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/adrex/apis/adrex-ai/revisions/4e6f0f0bc902?raw)