Authentication

Base URL

Send Ads API requests to:

https://api.ads.openai.com/v1

Authorization

The OpenAPI spec defines a bearer security scheme. Pass your Ads API key on every request:

Request formats

Most Ads API endpoints accept application/json. The upload endpoint supports two request formats:

• application/json with an image_url
• multipart/form-data with a binary file

Example request

Use GET /ad_account to confirm that your bearer token works.

curl -X GET "https://api.ads.openai.com/v1/ad_account" \
  -H "Authorization: Bearer $OPENAI_ADS_API_KEY" \
  -H "Accept: application/json"

{
  "id": "act_123",
  "name": "Acme Ads",
  "url": "https://www.acme.example",
  "preview_url": "https://preview.acme.example",
  "timezone": "UTC",
  "currency_code": "USD"
}