ChatGPT Ads Write
Create a campaign by itself (no ad group/ad)
POST https://api.adspirer.ai/api/v1/tools/create_chatgpt_campaign/execute
Authorization: Bearer sk_live_... — your Adspirer API key (required)Content-Type: application/json (required)Idempotency-Key: <uuid> — recommended for write operations to make retries safeAll tool arguments are wrapped in an arguments object.
| Field | Type | Description |
|---|---|---|
name | string required | Campaign name (3–1000 chars) |
daily_budget | number optional | Daily budget in the ACCOUNT'S currency (NOT USD, NOT cents; for 25/day send 25). Min 25/day. Provide this or budget_micros / lifetime_budget. |
budget_micros | integer optional | Daily budget in micros of the account currency (25 = 25,000,000). Alternative to daily_budget. |
lifetime_budget | number optional | Lifetime budget in the account currency (min 1). Use instead of a daily budget. |
bidding_type | string optional | How the campaign optimizes + bills: 'impressions' (CPM, the OpenAI default), 'clicks' (CPC), or 'conversions' (oCPC — optimizes toward clicks likely to convert, still billed per valid click). Defaults to 'clicks'. |
conversion_event_setting_ids | array optional | REQUIRED when bidding_type='conversions': exactly ONE event setting id to optimize toward. Get one from list_chatgpt_event_settings or create_chatgpt_event_setting. |
location_query | string optional | Target location by name, e.g. 'California' (resolved to a location id). |
location_ids | array optional | Explicit OpenAI location IDs to INCLUDE (alternative to location_query). |
exclude_location_query | string optional | A location to EXCLUDE by name, e.g. 'Texas' (resolved to a location id). Delivery skips this area. |
exclude_location_ids | array optional | Explicit OpenAI location IDs to EXCLUDE (alternative to exclude_location_query). |
custom_audience_ids | array optional | Custom audience IDs (caud_...) to INCLUDE — deliver only to users in at least one. Each audience needs ~25k+ matched users to include. |
exclude_custom_audience_ids | array optional | Custom audience IDs (caud_...) to EXCLUDE — skip users in any of these. No minimum size. |
platforms | array optional | Restrict delivery to these ChatGPT surfaces (leave unset = all): a subset of android_app, android_web, desktop_web, ios_app, ios_web, web. |
status | string optional | 'paused' (default) or 'active'. Created PAUSED unless you pass 'active'. |
description | string optional | Optional campaign description. |
query_string_template | string optional | URL query string appended to landing pages, e.g. 'utm_source=chatgpt&utm_campaign={campaign_id}'. Macros {campaign_id}, {ad_group_id}, {ad_id}, {ad_account_id} are auto-filled at delivery. |
start_time | integer optional | Optional unix start time. |
end_time | integer optional | Optional unix end time. |
{
"arguments": {
"name": "string",
"daily_budget": 1.0,
"budget_micros": 1,
"lifetime_budget": 1.0,
"bidding_type": "string",
"conversion_event_setting_ids": [
"string"
],
"location_query": "string"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for create_chatgpt_campaign)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "create_chatgpt_campaign"
}
{
"success": false,
"error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n - Acme Holdings (ad_account_id=\"act_123456789\")\n - Acme EU (ad_account_id=\"act_987654321\")",
"is_error": true,
"tool": "create_chatgpt_campaign"
}
{
"success": false,
"error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
"is_error": true,
"tool": "create_chatgpt_campaign",
"quota": {
"used": 150,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01",
"upgrade_url": "https://adspirer.ai"
}
}
Interactive: Swagger UI
Machine-readable: OpenAPI 3.1 spec · llms-full.txt
More tools: ChatGPT Ads · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai