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

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

Changed in 6 of the 56 revisions of this API.111

  • 2c04683ce6944See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • f5bd490b573111See the full diff
    • ●

      added the new card_verification_required enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • dd3865482f9f2See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      request property deprecated

      request-property-deprecated

  • 3e6ddf2a99ea1See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • 0dba7d004d752See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • bdd771244d761See the full diff
    • ○

      added the non-success response with the status

      response-non-success-status-added