Documentation menu

Create ad account

Create an ad account in a Business portfolio.

POSThttps://app.tryadeli.com/api/v1/ads/accounts

AuthorizationBearer <API key>How keys work

Request

curl --fail-with-body -X POST "https://app.tryadeli.com/api/v1/ads/accounts?accountId=00000000-0000-0000-0000-000000000000" \
  -H "Authorization: Bearer $ADELI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: client-a-ad-account" \
  -d '{
  "businessId": "1122334455",
  "name": "Client A — Ads",
  "timezone": "America/New_York",
  "currency": "USD"
}'

Response

{
  "adAccount": {
    "id": "act_1234567890",
    "accountId": "1234567890",
    "name": "Client A — Ads",
    "currency": "USD",
    "timezoneName": "America/New_York",
    "accountStatus": 1,
    "minDailyBudget": 100,
    "businessId": "1122334455",
    "businessName": "Client A"
  },
  "replayed": false
}

Creates an ad account in a Business portfolio the authorizing person administers. Meta has no API for personal ad accounts. The currency and time zone cannot be changed afterwards, and a portfolio may only hold a limited number of ad accounts — commonly one until it has spend history — which Meta reports as 422 provider_rejected.

An Idempotency-Key header is required, since a retry would be a second ad account: the same key replays 200 with the same account, 409 ad_account_create_failed if it failed, or 409 ad_account_create_in_progress. A new account is 201, and the account list is refreshed to include it.

Body

businessIdstringRequired: A portfolio from GET `/api/v1/ads/businesses`.
namestringRequired: Up to 100 characters.
timezonestringRequired: An IANA zone Adeli maps to Meta's time zone id, such as America/New_York or Europe/London.
currencystring: ISO 4217. Defaults to USD.