ChatGPT Ads / API Reference
openai_ads_create_chat_card_ad
OpenAI Ads tool — manages ads shown inside ChatGPT via the OpenAI Ads API. Create a 'chat_card' ad under an ad group. Defaults to PAUSED. Args: ad_group_id: Parent ad group ID. name: Ad name (3-1000 chars). title: Creative title (3-50 chars). body: Creative body (max 100 chars). target_url: Landing URL the ad links to (required for chat_card). file_id: ID of an uploaded image file (required for chat_card). status: 'paused' (default) or 'active'.
This is a write tool: it creates chat card ad in your ChatGPT Ads account. Claude asks you to confirm before it runs.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Create chat card ad in my ChatGPT Ads account for [ad group id], [name], [title].
It takes 6 required and 1 optional parameter.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_group_id | string | Yes | Ad Group Id |
name | string | Yes | Name |
title | string | Yes | Title |
body | string | Yes | Body |
target_url | string | Yes | Target Url |
file_id | string | Yes | File Id |
status | string | No | Status |