v2

latestOpenAPI 3.1.02026-08-075421692.0 MB

Connect

Connect an OpenAI Ads account

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 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.

redirectUristring uri

Optional URL to redirect to after successful connection

Response

OpenAI Ads connected successfully

accountIdstring

adAccountNamestring

redirectUrlstring