Synupv1
Criar chave
v1Recursos/Connections/postAtualizar uma configuração de boost

Atualizar uma configuração de boost

Edita uma configuração de boost existente e não arquivada. Somente os campos fornecidos são alterados.

post/api/v1/connections/boost-configs/update
connections:write
Corpo da solicitação
connectionIdstringobrigatório
A conta conectada proprietária da configuração de boost. Obrigatório. Procure com GET /api/v1/connections.
configIdstringobrigatório
A configuração de boost a ser atualizada. Deve pertencer a connectionId e não estar arquivada. Obrigatório.
adAccountIdstringopcional
Nova conta de anúncios da qual gastar, se estiver alterando.
namestringopcional
Novo nome para esta predefinição, se estiver alterando.
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).
dailyBudgetnumberopcional
Novo orçamento diário, na unidade monetária menor da plataforma, se estiver alterando.
durationDaysnumberopcional
Nova duração em dias, se estiver alterando.
delayHoursnumberopcional
Novo atraso em horas antes de impulsionar, se estiver alterando.
publisherPlatformsarray of stringopcional
Nova lista de superfícies de plataforma para impulsionar, se estiver alterando.
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/update
Sua chave de API
Corpo da solicitação*
{
  "data": {
    "boostConfig": {
      "id": "boost_1",
      "connectionId": "conn_1",
      "adAccountId": "adacct_1",
      "name": "Local awareness — $15/day",
      "platform": "facebook",
      "targeting": {
        "ageMin": 25,
        "ageMax": 55,
        "genders": [],
        "publisherPlatforms": [
          "facebook"
        ]
      },
      "dailyBudget": 15,
      "durationDays": 7,
      "delayHours": 0,
      "publisherPlatforms": [
        "facebook"
      ],
      "archived": false,
      "createdAt": "2026-01-15T10:00:00.000Z",
      "updatedAt": "2026-02-01T09:00:00.000Z"
    }
  }
}