> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexgenius.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect ChatGPT Ads

> Connect a ChatGPT Ads account to ApexGenius with an Ads API key, read spend and delivery from your AI, and pause or resume campaigns with approval.

**Status: Available.** Connect one ChatGPT ad account per saved connection with
an Ads API key from Ads Manager. Reads cover the account, campaigns, ad groups,
ads, conversion event settings and daily insights. Pause and activate are the
only writes and both wait for your approval.

[Explore the ChatGPT Ads connector](https://www.apexgenius.ai/connectors/chatgpt-ads).

## Connect and read your campaigns

**Before you start**

* A ChatGPT Ads Manager account with access to the ad account you want to connect.
* An Ads API key created in Ads Manager under Settings. Each key covers one ad account. It is not the Conversions API key used by a website pixel.

<Steps>
  <Step title="Create an Ads API key in Ads Manager">
    In ChatGPT Ads Manager open Settings, then General. Under API Keys choose Create New Key, name it, and copy the key once. Ads Manager shows it masked afterwards. It is the Ads Management key, not a conversion key.
  </Step>

  <Step title="Open ChatGPT Ads in Connections">
    Sign in to ApexGenius, open Connections, choose ChatGPT Ads, and select Connect.
  </Step>

  <Step title="Enter the Ads API key">
    Paste the key from Ads Manager Settings. ApexGenius supplies the api.ads.openai.com address, checks the key against the ad account, and stores it encrypted.
  </Step>

  <Step title="Review the tools">
    Open Tools. Reads cover the account, campaigns, ad groups, ads and daily insights. Pause and activate always ask for approval, and activating starts spend.
  </Step>

  <Step title="Verify the connected ad account">
    Use Test connection, then ask your AI the question below. Compare the account name and currency with Ads Manager and check Tool Activity.
  </Step>
</Steps>

**Try a first question with your AI agent**

```text theme={"system"}
List my ChatGPT Ads campaigns with status and daily budget, and name the connected ad account and currency. Do not pause or activate anything.
```

A successful campaign list confirms the key and the account. It changes nothing and spends nothing, and it does not test pause or activate.

## Tools and the ChatGPTAds skill

Open **Skills** on the connection to read **ChatGPTAds**, or read that MCP
prompt in a compatible AI client. It explains how to read delivery, how
conversions depend on the events attached in Ads Manager, and how the two
state changes work.

Three ApexGenius tools route fifteen reviewed operations:

| ApexGenius tool                | ChatGPT Ads operations                                                                                                                                                                                                                                        | Access            |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
| `openai_ads_search_operations` | Lists the reviewed operations below                                                                                                                                                                                                                           | Read              |
| `openai_ads_read_operation`    | `get_ad_account`, `list_ad_accounts`, `list_campaigns`, `get_campaign`, `get_account_insights`, `get_campaign_insights`, `list_ad_groups`, `get_ad_group`, `get_ad_group_insights`, `list_ads`, `get_ad`, `get_ad_insights`, `list_conversion_event_settings` | Read              |
| `openai_ads_write_operation`   | `pause_campaign`, `activate_campaign`                                                                                                                                                                                                                         | Requires approval |

Your AI discovers the tools with `apex_search_tools`. Reads use
`apex_call_read_tool`; the two writes use `apex_call_write_tool` and return
`approval_required` until a person approves in ApexGenius.

## What is not exposed

Creating campaigns or ads, editing budgets, spend limits, archiving, API key
creation and image uploads stay in Ads Manager. Archive cannot be undone, so it
is not offered. Pause is the undo for activate, and activate is the undo for
pause.

## Measurement

Conversions in insights count only the conversion events attached to a
campaign in Ads Manager. A campaign with no event attached reports zero
conversions even when leads arrived. Your website pixel and Conversions API
key are configured in Ads Manager and are separate from this connection.