v1Recursos/Connections/postCriar uma configuração de boost
Criar uma configuração de boost
Salva uma nova configuração de boost reutilizável (segmentação, orçamento diário e duração) na conta de anúncios de uma conta conectada. Isso apenas armazena uma predefinição para uso posterior — não impulsiona uma publicação, não envia nada à plataforma de anúncios, e não gasta dinheiro algum. Dinheiro só é gasto quando esta configuração salva é posteriormente aplicada para impulsionar uma publicação específica.
post
connections:write/api/v1/connections/boost-configsCorpo da solicitação
connectionIdstringobrigatório
A conta conectada à qual vincular esta configuração de boost. Obrigatório. Procure com GET /api/v1/connections.
adAccountIdstringobrigatório
A conta de anúncios da qual gastar quando esta configuração for usada. Deve pertencer a connectionId. Obrigatório.
namestringobrigatório
Um nome para esta predefinição, exibido ao selecioná-la posteriormente. Obrigatório.
targetingobjectopcional
Todos os campos são opcionais. Um objeto vazio segmenta o público padrão mais amplo da plataforma.
ageMinnumberopcional
Idade mínima do público.
ageMaxnumberopcional
Idade máxima do público.
gendersarray of numberopcional
Gêneros do público a segmentar: 1 para masculino, 2 para feminino.
geoLocationsobjectopcional
Segmentação geográfica: países, regiões, cidades e/ou códigos postais.
countriesarray of stringopcional
regionsarray of objectopcional
keystringopcional
namestringopcional
citiesarray of objectopcional
keystringopcional
namestringopcional
radiusnumberopcional
distanceUnitstringopcional
zipsarray of objectopcional
keystringopcional
namestringopcional
interestsarray of objectopcional
Categorias de interesse a segmentar.
idstringopcional
namestringopcional
publisherPlatformsarray of stringopcional
Em quais superfícies de plataforma segmentar, ex.: ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)opcional
Restringe o público a pessoas que curtem a página (fans) ou também aos amigos delas (fans_of_fans).
dailyBudgetnumberobrigatório
Orçamento diário, na unidade monetária menor da plataforma (ex.: centavos). Deve ser positivo. Obrigatório.
durationDaysnumberobrigatório
Quantos dias o boost deve durar quando aplicado. Deve ser positivo. Obrigatório.
delayHoursnumberopcional
Horas a esperar após a publicação de um post antes de impulsioná-lo. O padrão é 0.
publisherPlatformsarray of stringopcional
Em quais superfícies de plataforma impulsionar, ex.: ["facebook", "instagram"].
Resposta
dataobjectopcional
boostConfigobjectopcional
idstringopcional
Identificador único da configuração de boost.
connectionIdstringopcional
ID da conta conectada à qual esta configuração de boost pertence.
adAccountIdstringopcional
ID da conta de anúncios da qual esta configuração de boost gasta.
namestringopcional
Nome desta predefinição.
platformstringopcional
Plataforma em que esta configuração de boost é executada, correspondendo à sua conta conectada.
targetingobjectopcional
Configurações de segmentação para esta predefinição.
ageMinnumberopcional
Idade mínima do público.
ageMaxnumberopcional
Idade máxima do público.
gendersarray of numberopcional
Gêneros do público a segmentar: 1 para masculino, 2 para feminino.
geoLocationsobjectopcional
Segmentação geográfica: países, regiões, cidades e/ou códigos postais.
interestsarray of objectopcional
Categorias de interesse a segmentar.
publisherPlatformsarray of stringopcional
Em quais superfícies de plataforma segmentar, ex.: ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)opcional
Restringe o público a pessoas que curtem a página (fans) ou também aos amigos delas (fans_of_fans).
dailyBudgetnumberopcional
Orçamento diário, na unidade monetária menor da plataforma (ex.: centavos).
durationDaysnumberopcional
Quantos dias o boost dura quando aplicado.
delayHoursnumberopcional
Horas a esperar após a publicação de um post antes de impulsioná-lo.
publisherPlatformsarray of stringopcional
Em quais superfícies de plataforma esta predefinição impulsiona.
archivedbooleanopcional
Se esta predefinição foi arquivada.
createdAtstringopcional
Quando esta predefinição foi criada, como timestamp ISO 8601.
updatedAtstringopcional
Quando esta predefinição foi atualizada por último, como timestamp ISO 8601.
adAccountobjectopcional
Um breve resumo da conta de anúncios da qual esta predefinição gasta, ou null.
platformAccountIdstringopcional
O identificador próprio da plataforma para essa conta de anúncios.
namestringopcional
Nome de exibição dessa conta de anúncios.
currencystringopcional
Moeda em que essa conta de anúncios cobra, ou null.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/connections/boost-configs
Sua chave de API
Corpo da solicitação*
{
"data": {
"boostConfig": {
"id": "boost_1",
"connectionId": "conn_1",
"adAccountId": "adacct_1",
"name": "Local awareness — $10/day",
"platform": "facebook",
"targeting": {
"ageMin": 25,
"ageMax": 55,
"genders": [],
"publisherPlatforms": [
"facebook"
]
},
"dailyBudget": 10,
"durationDays": 7,
"delayHours": 0,
"publisherPlatforms": [
"facebook"
],
"archived": false,
"createdAt": "2026-01-15T10:00:00.000Z",
"updatedAt": "2026-01-15T10:00:00.000Z"
}
}
}