ChatGPT Ads Write
Create a complete ChatGPT ad in one step: campaign → ad group → image upload → chat_card ad
POST https://api.adspirer.ai/api/v1/tools/launch_chatgpt_ad/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 |
headline | string required | Ad headline — 3 to 50 characters |
body | string required | Ad body text — max 100 characters |
image_url | string required | PUBLIC image URL (PNG/JPG, square, ≥256px) for the chat_card creative |
target_url | string required | Destination URL the ad links to (http/https) |
daily_budget | number optional | Daily budget in dollars (min $1/day). Provide this or budget_micros. |
budget_micros | integer optional | Daily budget in micros (alternative to daily_budget) |
location_query | string optional | Target location by name, e.g. 'California' (resolved via geo lookup) |
location_ids | array optional | Explicit OpenAI location IDs (alternative to location_query) |
max_bid | number optional | Max CPC bid in dollars (default $2) |
context_hints | array optional | Audience/context hints for the ad group |
description | string optional | Optional campaign description |
ad_group_name | string optional | Optional ad-group name (defaults to '<campaign> - ad group') |
{
"arguments": {
"name": "string",
"headline": "string",
"body": "string",
"image_url": "https://example.com",
"target_url": "https://example.com",
"daily_budget": 1.0,
"budget_micros": 1,
"location_query": "string",
"location_ids": [
"string"
],
"max_bid": 1.0,
"context_hints": [
"string"
]
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for launch_chatgpt_ad)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "launch_chatgpt_ad"
}
{
"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": "launch_chatgpt_ad"
}
{
"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": "launch_chatgpt_ad",
"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