AI Agents for Openai

Retrieve the ad account associated with the API key, including id, name, timezone and currency.

Retrieve aggregated performance insights (impressions, clicks, spend, ctr, cpc, cpm) for the whole ad account.

List campaigns in the ad account with pagination support.

Create a new campaign with a name, status, and lifetime budget. Use product_feed mode for catalog-driven campaigns.

Retrieve a single campaign by its id.

Update an existing campaign. Include the full budget object when changing the budget.

Activate (enable) a paused campaign by its id.

Pause an active campaign by its id.

Archive a campaign by its id.

Retrieve aggregated performance insights for a single campaign by its id.

List the ad groups belonging to a campaign.

Create a new ad group inside a campaign with a bidding configuration.

Retrieve a single ad group by its id.

Update an existing ad group by its id.

Activate (enable) a paused ad group by its id.

Pause an active ad group by its id.

Archive an ad group by its id.

Retrieve aggregated performance insights for a single ad group by its id.

List the ads belonging to an ad group.

Create a new ad inside an ad group with a creative. chat_card creatives require a target_url and an uploaded file_id.

Retrieve a single ad by its id, including its review status.

Update an existing ad by its id. Send the full creative object when changing the creative.

Activate (enable) a paused ad by its id.

Pause an active ad by its id.

Archive an ad by its id.

Retrieve aggregated performance insights for a single ad by its id.

Make a generic call to any OpenAI Ads API endpoint by specifying the method, URL and an optional request body. Useful for advanced insights queries and endpoints not covered by the dedicated tools.

Installs OpenAI Ads tools into the conversation. You can manage campaigns, ad groups, and ads, and read performance insights through the OpenAI Advertiser API.

Installs read-only OpenAI Ads tools into the conversation. You can list and inspect campaigns, ad groups, and ads, and read performance insights without making changes.