Skip to content

openai_ads_create_custom_audience

Preview and confirm a ChatGPT Ads custom audience, empty or with first customers.

View as Markdown

Preview and confirm a ChatGPT Ads custom audience, empty or with first customers. Emails and E.164 phones are normalized and SHA-256 hashed by the server; raw identifiers are never sent, saved or returned. Not for campaigns targeting the EEA or Switzerland.

Kind
Write
Discovery
Reachable through search_tools and run_tool
Account parameter
adAccountId
Endpoint
https://mcp.getmcpads.com/openai-ads/mcp

Parameters

Parameters
NameTypeRequiredNotes
adAccountIdstringRequiredExact verified and selected ChatGPT Ads account ID; the token is scoped to this account.
namestringRequiredAudience name, at least 3 characters, unique among the account's active audiences.
descriptionstringOptionalOptional internal note about the audience.
membersarrayOptionalOptional first customers, sent as one hashed list file. Omit for an empty audience (accounts with small audiences enabled), then add members.
requestIdstringRequiredStable UUID for this exact change. Reuse it to read its receipt; never replace an uncertain outcome.
confirmbooleanOptionalFalse returns a saved preview. True applies only the exact preview the person approved. Default: false.
confirmationTokenstringOptionalSaved preview token returned for these arguments.

Calling it

json · Through run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "openai_ads_create_custom_audience",
    "args": {
      "adAccountId": "<string>",
      "name": "<string>",
      "requestId": "<string>"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.

Esc

Type to search