Create campaign - Audiohook Developer Docs

✨ Create a Campaign

Creates a new campaign.

📤 Request Example

curl -X POST https://betaapi.audiohook.com/v2/companies/:companyUUID/campaigns \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "request_headers": [
      { "name": "X-Request-Header", "value": "Header value" }
    ],
    "body": {
      "draft": false,
      "campaign_type": 1,
      "name": "Test campaign Docs",
      "pacing": 5,
      "status": false,
      "budget_type": 1,
      "budget_value": 1,
      "start_date": "2023-02-15",
      "end_date": "2023-02-16",
      "advertiser_id": "test-advertiser-uuid"
    }
  }'

🌐 HTTP Request

POST /v2/companies/:companyUUID/campaigns

🧾 Body Parameters

Parameter	Required	Type	Description
draft	✅	boolean	Draft mode enabled or not.
campaign_type	✅	int	Type of campaign: 1 - Impression, 2 - CPA.
name	✅	string	Name of the campaign.
pacing	✅	int	Pacing strategy: 1 to 6.
status	✅	boolean	If the campaign is active.
budget_type	✅	int	Budget type: 1 - Dollars, 2 - Impressions.
budget_value	✅	int	Budget amount.
start_date	✅	string	Start date (format: Y-M-D).
end_date	✅	string	End date (format: Y-M-D).
advertiser_id	✅	string	UUID of advertiser.
audiences	❌	array	Selected audience list.
dayparting_enabled	❌	boolean	Whether dayparting is enabled.
dayparting	❌	array	Dayparting info.
geo_ui	❌	array	Geographic targeting list.
google_places	❌	array	Google Places API raw info.
devices_enabled	❌	boolean	Whether device targeting is enabled.
brand_safety_filter	❌	object	Brand safety preferences.
creatives	❌	array	Creative weights or priorities.
auto_optimized	❌	boolean	Auto optimization flag.
conversion_type	❌	int	Conversion type.
conversion_value	❌	float	Conversion value.
goal_optimization	❌	string	Optimization goal: `no`, `partial`, `full`.