Fetches the OpenAI Ads account associated with the configured API key, including ID, name, destination URL, timezone, currency, and brand review status.

Updates the ad account display name or assigns a brand favicon file_id, triggering an automatic brand review required for ad serving.

List campaigns in the current OpenAI Ads account with pagination.

Fetch a single OpenAI Ads campaign by its ID.

Create an ad campaign. Note: lifetime_spend_limit_micros is in currency millionths (e.g. 25000000 = $25.00 USD). Bidding type cannot be changed after creation.

Update campaign budget, schedule, status, or description. Note: bidding_type cannot be updated.

Explicitly activate, pause, or archive a campaign. Archiving is irreversible.

Deep-copies an existing campaign along with all its child ad groups and ads into a new campaign (created in paused state by default). Allows overriding name, budget, or flight dates.

List ad groups for a specific parent campaign ID.

Fetch an ad group by its ID.

Create an ad group under a campaign. Billing event must match campaign objective ('impression' for CPM; 'click' for CPC and oCPC). max_bid_micros is in millionths (e.g. 60000 = $0.06/event or $60 CPM; 100000000 = $100 CPA bid).

Update ad group name, description, context_hints, status, or bidding_config.

Activate, pause, or archive an ad group. Archiving is irreversible.

Upload a remote image URL to OpenAI Ads and receive a reusable file_id for ads (chat_card) or brand review (account_favicon).

List ads for a specific ad group ID.

Fetch an ad by ID, including creative details and review_status.

Create an ad in an ad group. Supports 'chat_card' (title 3-50 chars, body max 100 chars, destination target_url, and uploaded file_id) or 'product_ad_template' (for product feed campaigns).

Generate a 24-hour temporary web preview URL for an existing ad.

Activate, pause, or archive an ad. Archiving is permanent.

Generates realistic, high-intent ChatGPT user queries (custom_intent_queries) and conversational sponsored ad copy tailored to your product, audience, and value propositions.

Retrieve advertising performance metrics (impressions, clicks, spend, CTR, CPC, CPM). Supports aggregation_level ('ad_account', 'campaign', 'ad_group', 'ad'), time_granularity ('hourly', 'daily', 'monthly', 'none'), segments (['product'], ['country'], ['device']), and zero-impression items.

Retrieve attributed conversion totals (conversions, click_through_conversions, view_through_conversions). 'conversions' is always equal to 'click_through_conversions'. View-through conversions use a fixed 1-day impression window for reporting.

Creates a web conversion source and returns both an internal source ID (clidsrc_*) and a public pixel_id. Web pixels automatically support automatic advanced matching.

Test and verify incoming browser pixel events. Returns up to 50 raw events received by OpenAI from the JavaScript pixel SDK during the previous 15 minutes.

Generate a server-side Conversions API key to send conversion events directly from backend servers. Note: store securely in server secrets.

Defines an active conversion goal (e.g. 'order_created', 'lead_created', 'registration_completed') bound to a pixel source ID. Required for oCPC conversion-optimized campaigns.

List all conversion definitions configured for the current ad account.

Dispatches a test or live server-side conversion event (e.g., 'order_created', 'lead_created', 'add_to_cart') via the OpenAI Conversions API. Automatically hashes plain emails/phones with SHA-256 and attaches deduplication tokens.

List custom audiences for the current ad account. Use 'intended_use' ('inclusion', 'exclusion', 'bid_multiplier') to filter only eligible audiences.

Retrieve audience status, privacy-preserving size ranges (e.g. under_25k, 25k_100k), and current membership_revision.

Creates a new custom audience. Can create an empty audience for incremental builds or attach an uploaded file_id.

Add or remove customer identifiers from an existing custom audience. Accepts inline identifiers or an uploaded file_id. Returns an asynchronous operation ID.

Merges 2 to 64 existing, ready audiences in the same ad account into a new union audience.

Permanently archive a custom audience. Archived audiences cannot be restored.

Poll the status of an asynchronous membership operation (add, remove, replace, merge) until 'succeeded' or 'failed'.

Normalizes raw emails (trimmed, lowercase) and phone numbers (E.164 standard) into SHA-256 hashes per OpenAI specification. Optionally uploads the hashed members directly to a custom audience.

Delta update prices, titles, or stock availability for existing variants in a linked merchant feed without re-uploading the entire catalog.

Submits an asynchronous bulk job with up to 1,000 operations (campaign.create/update, ad_group.create/update, ad.create/update). Entities can link via campaign_idempotency_key and ad_group_idempotency_key.

Poll bulk job progress (pending, in_progress, completed, partially_failed, failed) and inspect per-operation execution results.

Search targetable locations (countries, regions, and DMAs) by keyword query to obtain location IDs for campaign targeting.

Comprehensive tracking audit. Inspects ad account brand approval, configured conversion event settings, and optionally polls the 15-minute live pixel stream to diagnose missing events, tag misconfigurations, and CAPI readiness.

Analyzes campaign metrics (impressions, clicks, spend, CTR, CPC, conversions, CPA). Provides diagnostic assessments (STRONG, MODERATE, NEEDS_ATTENTION) and actionable optimization recommendations.

Scans recent delivery and conversion metrics for runaway spend, zero-conversion budget drain, low-CTR creative burnout, and abnormal CPA spikes across campaigns. Recommends immediate remediation actions.