Connect

Connect an OpenAI Ads account

Changed on

Connect an OpenAI Ads account using an API key from ChatGPT Ads Manager.

The key grants full campaign write access on OpenAI's side (OpenAI does not offer a read-only key scope). Zernio uses it to read ads and performance, and to create and manage campaigns you set up through Zernio (create, status, budget, and cancel). Campaigns created directly in ChatGPT Ads Manager can still be managed there.

post/v1/connect/openai-ads/credentials

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/connect/openai-ads/credentials
  • Auth: HTTP bearer

Request body

apiKeystring required

API key from ChatGPT Ads Manager (Settings). Grants full read/write access on OpenAI's side; Zernio only ever reads with it.

profileIdstring required

Your Zernio profile ID

statestring

Optional state passthrough for the connect flow.

redirect_urlstring uri

Optional URL to redirect to after successful connection, echoed back as redirectUrl.

redirectUristring uri

Alias of redirect_url, kept for existing callers

Response

OpenAI Ads connected successfully

accountIdstring
adAccountNamestring
redirectUrlstring

Changes