Pular para o conteúdo

GET /v1/ads/accounts

GET
/v1/ads/accounts
curl --request GET \
--url https://seu-endereco-da-api/v1/ads/accounts \
--header 'Authorization: Bearer <token>'

Permissão que a Chave de acesso precisa: Ler Meta Ads (ads:read).

Media typeapplication/json
Array<object>
object
id
required
string
externalAccountId
required

Account_id da Meta, só dígitos; o act_ é prefixo de rota

string
name
required
string
currency
required
string
nullable
timezone
required
string
nullable
businessId
required
string
nullable
businessName
required
string
nullable
metaStatus
required
string
Allowed values: active disabled unsettled pending_risk_review pending_settlement in_grace_period pending_closure closed unknown
grantedScopes
required
Array<string>
Allowed values: ads_read ads_management business_management leads_retrieval pages_show_list pages_read_engagement pages_manage_metadata pages_manage_ads pages_messaging
missingScopes
required
Array<string>
Allowed values: ads_read ads_management business_management leads_retrieval pages_show_list pages_read_engagement pages_manage_metadata pages_manage_ads pages_messaging
canManage
required

Ads_read + ads_management com token vivo

boolean
tokenStatus
required

Expired é derivado na leitura quando tokenExpiresAt já passou

string
Allowed values: valid expiring expired invalid unknown
tokenExpiresAt
required
string format: date-time
nullable
tokenCheckedAt
required
string format: date-time
nullable
connectedBy
required
object
id
required
string
name
required
string
nullable
email
required
string
connectedAt
required

Última conexão ou reconexão desta conta; checagens de token não a movem

string format: date-time

Example

[
{
"metaStatus": "active",
"grantedScopes": [
"ads_read"
],
"missingScopes": [
"ads_read"
],
"tokenStatus": "valid"
}
]