ChatGPT Ads Write
Create a custom audience — empty (add members after) or seeded from an uploaded file_id
POST https://api.adspirer.ai/api/v1/tools/create_chatgpt_custom_audience/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 | Audience name (≥3 chars). |
description | string optional | Optional description. |
file_id | string optional | An uploaded file id (from upload_chatgpt_custom_audience_file) to seed the audience. Omit to create an empty audience and add members later. |
identifier_type | string optional | For a single-type file: 'email', 'phone', 'email_sha256', 'phone_number_sha256', or 'gaid'. Defaults to 'email'. |
identifier_resolution | string optional | Set 'auto' when a CSV mixes identifier types. |
filename | string optional | The file's name (must end .csv or .txt) — required with file_id. |
mimetype | string optional | 'text/csv' or 'text/plain' — required with file_id. |
file_size | integer optional | File size in bytes (1–500,000,000) — required with file_id. |
{
"arguments": {
"name": "string",
"description": "string",
"file_id": "string",
"identifier_type": "string",
"identifier_resolution": "string",
"filename": "string",
"mimetype": "string"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for create_chatgpt_custom_audience)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "create_chatgpt_custom_audience"
}
{
"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_custom_audience"
}
{
"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_custom_audience",
"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