POST /v1/ads/accounts/candidates
POST
/v1/ads/accounts/candidates
const url = 'https://seu-endereco-da-api/v1/ads/accounts/candidates';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"selectionToken":"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/candidates \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "selectionToken": "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
Example generated
{ "selectionToken": "example"}Responses
Seção intitulada “Responses”Media typeapplication/json
object
source
required
Session lê o token da sessão de escolha; stored, o login vivo mais recente
string
grantedScopes
required
Array<string>
missingScopes
required
Array<string>
businesses
required
Array<object>
object
id
required
Null agrupa as contas sem Business Manager, sempre por último
string
name
required
string
accounts
required
Array<object>
object
externalAccountId
required
string
name
required
string
currency
required
string
timezone
required
string
businessId
required
string
businessName
required
string
metaStatus
required
string
connected
required
Já conectada neste tenant
boolean
Example
{ "source": "session", "grantedScopes": [ "ads_read" ], "missingScopes": [ "ads_read" ], "businesses": [ { "accounts": [ { "metaStatus": "active" } ] } ]}