Docs menu
Get started
What is Opus GrowthQuickstartAdd to your AIHow it worksSafety and approvalCreditsPlansFAQAI apps
All AI appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOther MCPConnect ad platforms
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencies and MCCConnect data sources
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWebsites and SEO
AI ServerWordPressSEO IntelligenceClick fraudTool reference
All toolsGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceClick fraudCross-channelAccount and billingLanguage
Create ChatGPT Ads Conversion Event
Creates a ChatGPT Ads conversion event setting (which tracked action counts as a conversion) on one pixel source.
- Type
- Makes changes
- Credits
- 5
- Platform
- ChatGPT Ads
- Approval
- Preview first, applied after you approve
What it does
Creates a ChatGPT Ads conversion event setting (which tracked action counts as a conversion) on one pixel source.
`event_type`: one of OpenAI's standard events — appointment_scheduled, lead_created, order_created, registration_completed, subscription_created, trial_started, checkout_started, items_added, contents_viewed, page_viewed, app_installed, app_opened — or `custom` with `custom_event_name` (lowercase letters, digits, _ or -, up to 64 characters, not a built-in name). `source_id` is the pixel source id (cds_…) from chatgpt_ads_conversion_setup; left empty it uses the account's only source. The attribution window is 30 days, as OpenAI requires. A setting does not send events by itself (the site's pixel or server sends that event), and only a STANDARD event can be the goal of a conversions-objective campaign. Attach it to campaigns with update_chatgpt_ads_campaign. confirm=false returns a dry run.
MCP: create_chatgpt_ads_event_setting
How to use it
You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.
Parameters
| Name | Type | Required | Default | |
|---|---|---|---|---|
| name | string | Required | · | Human-readable name for the resource being created or updated. |
| event_type | string | Required | · | app_installed · app_opened · appointment_scheduled · checkout_started · contents_viewed · custom · items_added · lead_created · order_created · page_viewed · registration_completed · subscription_created · Provider-specific event type accepted by this operation. Use a supported value from the tool documentation or returned provider data. |
| source_id | string | Optional | · | Exact source identifier to target. Use the ID returned by an Opus Growth list or create operation, not a display name. |
| custom_event_name | string | Optional | · | Name of the custom event to select, create, or display for this operation. |
| confirm | boolean | Optional | false | Safety confirmation for a state-changing operation. Leave false to preview or validate; set true only after the user explicitly approves the shown change. |
| account | string | Optional | · | Connected account selector for this operation. Use the exact account ID or account value accepted by this tool; when in doubt, obtain it from the relevant account-listing tool. |
Related tools
chatgpt_ads_ad_previewChatGPT Ads Conversion Setupchatgpt_ads_conversion_setupChatGPT Ads Object Detailschatgpt_ads_detailsChatGPT Ads Location Lookupchatgpt_ads_geo_lookupChatGPT Ads Insightschatgpt_ads_insightsChatGPT Ads Spend Limitschatgpt_ads_spend_limitsChatGPT Ads Statuschatgpt_ads_statusConnect ChatGPT Adsconnect_chatgpt_adsCreate ChatGPT Ads Adcreate_chatgpt_ads_ad