ChatGPT Ads Write
Send a REAL server-side conversion (Conversions API) with advanced matching: an event_type (order_created, lead_created, …), value + currency, an order/event id for dedup, and customer-matching fields
POST https://api.adspirer.ai/api/v1/tools/send_chatgpt_conversion_event/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 |
|---|---|---|
event_type | string required | A standard event: order_created, lead_created, checkout_started, items_added, contents_viewed, page_viewed, registration_completed, appointment_scheduled, subscription_created, trial_started, or 'custom'. |
custom_event_name | string optional | Required when event_type='custom'. |
value | number optional | Purchase/conversion value amount, in the currency's MINOR unit (e.g. cents) as an integer, or a decimal in the major unit — sent as data.amount with currency. |
amount | integer optional | Alias for value (integer minor units). |
currency | string optional | ISO-4217 currency code (required with a value/amount), e.g. 'USD'. |
order_id | string optional | A stable event id (dedup key) — e.g. your order id. Also accepted as event_id. |
event_id | string optional | Explicit dedup event id (matches the pixel event id for dedup). |
source_url | string optional | The page URL where the conversion happened (required for web events). |
action_source | string optional | 'web' (default), 'mobile_app', 'offline', 'physical_store', 'phone_call', 'email', or 'other'. |
emails | array optional | Customer emails (raw — hashed server-side, first 3 used). Improves match rate. |
phones | array optional | Customer phone numbers, E.164 (raw — hashed server-side, first 3 used). |
first_names | array optional | First names (raw — hashed server-side). |
last_names | array optional | Last names (raw — hashed server-side). |
external_ids | array optional | Your stable customer ids (raw — hashed server-side). |
emails_sha256 | array optional | Already SHA-256-hashed emails (if you hashed them yourself). |
phone_numbers_sha256 | array optional | Already SHA-256-hashed phone numbers. |
countries | array optional | Two-letter country codes (raw). |
cities | array optional | City names (raw). |
regions | array optional | State/province/region (raw). |
postal_codes | array optional | Postal/ZIP codes (raw). |
ip_address | string optional | Customer IP (IPv4/IPv6). |
user_agent | string optional | Customer browser user-agent string. |
android_advertising_id | string optional | Raw Android GAID (UUID). |
contents | array optional | Line items: [{id, name, quantity, amount, currency, ...}]. |
plan_id | string optional | Subscription/trial plan id (for subscription_created/trial_started). |
validate_only | boolean optional | If true, validate the event without recording it (a dry run). default: false |
{
"arguments": {
"event_type": "string",
"custom_event_name": "string",
"value": 1.0,
"amount": 1,
"currency": "string",
"order_id": "string",
"event_id": "string"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for send_chatgpt_conversion_event)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "send_chatgpt_conversion_event"
}
{
"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": "send_chatgpt_conversion_event"
}
{
"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": "send_chatgpt_conversion_event",
"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