create_chatgpt_conversions_api_key

ChatGPT Ads Write

Create a Conversions API key for server-side conversion events

Endpoint

POST https://api.adspirer.ai/api/v1/tools/create_chatgpt_conversions_api_key/execute

Headers

Authorization: Bearer sk_live_... — your Adspirer API key (required)
Content-Type: application/json (required)
Idempotency-Key: <uuid> — recommended for write operations to make retries safe

Description

Create a Conversions API key for server-side conversion events. The secret is shown ONCE and (by default) stored encrypted so Adspirer can send events immediately. It cannot be retrieved again later, and cannot be deleted via the API.

Request body

All tool arguments are wrapped in an arguments object.

Field	Type	Description
`name`	`string` required	A descriptive name for the Conversions API key (3–1000 characters).
`store`	`boolean` optional	If true (default), save the key encrypted so Adspirer can send server-side conversions immediately. The raw key is also returned once. default: `true`
`overwrite`	`boolean` optional	If a Conversions API key is already stored, keep it unless this is true. Keys are permanent and the stored one may already be in use, so replacing it is opt-in. default: `false`

Example request

{
  "arguments": {
    "name": "string",
    "store": true,
    "overwrite": false
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for create_chatgpt_conversions_api_key)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "create_chatgpt_conversions_api_key"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "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_conversions_api_key"
}

402 — Quota exhausted

{
  "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_conversions_api_key",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

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