Skip to content

openai_ads_add_custom_audience_members

Preview and confirm adding up to 10,000 customers to a ready ChatGPT Ads custom audience.

View as Markdown

Preview and confirm adding up to 10,000 customers to a ready ChatGPT Ads custom audience. Emails and E.164 phones are normalized and SHA-256 hashed by the server; raw identifiers are never sent, saved or returned. Then poll openai_ads_get_audience_operation.

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.
customAudienceIdstringRequiredExact native ID of a ready custom audience in the selected account.
membersarrayRequiredCustomers, one identifier each: email, phone (E.164 with + and country code), or an existing SHA-256 digest (email_sha256, phone_number_sha256). The server normalizes and hashes them; raw values are never sent, saved or returned.
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_add_custom_audience_members",
    "args": {
      "adAccountId": "<string>",
      "customAudienceId": "<string>",
      "members": "<array>",
      "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