POST /v1/ads/accounts
POST
/v1/ads/accounts
const url = 'https://seu-endereco-da-api/v1/ads/accounts';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"selectionToken":"example","externalAccountIds":["example"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://seu-endereco-da-api/v1/ads/accounts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "selectionToken": "example", "externalAccountIds": [ "example" ] }'Permissão que a Chave de acesso precisa: Gerenciar Meta Ads (ads:manage).
Authorizations
Seção intitulada “Authorizations”Request Bodyrequired
Seção intitulada “Request Bodyrequired”Media typeapplication/json
object
selectionToken
string
externalAccountIds
required
Array<string>
Example generated
{ "selectionToken": "example", "externalAccountIds": [ "example" ]}Responses
Seção intitulada “Responses”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
timezone
required
string
businessId
required
string
businessName
required
string
metaStatus
required
string
grantedScopes
required
Array<string>
missingScopes
required
Array<string>
canManage
required
Ads_read + ads_management com token vivo
boolean
tokenStatus
required
Expired é derivado na leitura quando tokenExpiresAt já passou
string
tokenExpiresAt
required
string format: date-time
tokenCheckedAt
required
string format: date-time
connectedBy
required
object
id
required
string
name
required
string
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" }]