Pular para o conteúdo

POST /v1/ads/accounts/candidates

POST
/v1/ads/accounts/candidates
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).

Media typeapplication/json
object
selectionToken
string
>= 1 characters

Example generated

{
"selectionToken": "example"
}
Media typeapplication/json
object
source
required

Session lê o token da sessão de escolha; stored, o login vivo mais recente

string
Allowed values: session stored
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
businesses
required
Array<object>
object
id
required

Null agrupa as contas sem Business Manager, sempre por último

string
nullable
name
required
string
accounts
required
Array<object>
object
externalAccountId
required
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
connected
required

Já conectada neste tenant

boolean

Example

{
"source": "session",
"grantedScopes": [
"ads_read"
],
"missingScopes": [
"ads_read"
],
"businesses": [
{
"accounts": [
{
"metaStatus": "active"
}
]
}
]
}