Skip to content

Ad account detail

GET /api/marketing/ad-accounts/{id}

:id is the Neike uuid, not Meta’s act_…. An account of another client answers 404. Requires the marketing:read scope.

StatusDescriptionSchema
200—AdAccountDto
Terminal window
curl -X GET https://api.neike.dev/api/marketing/ad-accounts/{id} \
-H "x-neike-api-key: whk_live_…"
FieldTypeDescription
idstringrequiredAccount id in Neike (uuid).
providermetarequiredAds provider of the account. Today there is only one: meta.
ad_account_idstringrequiredAccount id in Meta, with prefix. Example: "act_123456789".
account_idstringrequiredThe same id without the act_ prefix. Example: "123456789".
namestringrequiredExample: "Cuenta principal".
currencystringrequiredAccount currency in Meta. Example: "ARS".
timezone_namestringrequiredExample: "America/Argentina/Buenos_Aires".
account_statusnumberrequiredMeta numeric enum (1 = active, 2 = disabled…). Example: 1.
account_status_labelstringrequiredThe same status as text, already translated. Example: "active".
business_idstringoptional—
business_namestringoptional—
statusavailable · active · disabled · revokedrequiredStatus in Neike: available (connected, not yet chosen), active (operable), disabled (paused by the client) or revoked (Meta invalidated the token).
last_synced_atstring (date-time)required—
created_atstring (date-time)required—