Synupv1
Create a key
v1Resources/Connections/postUpdate a boost config

Update a boost config

Edits an existing, non-archived boost configuration. Only the fields you provide are changed.

post/api/v1/connections/boost-configs/update
connections:write
Request body
connectionIdstringrequired
The connected account that owns the boost config. Required. Look it up with GET /api/v1/connections.
configIdstringrequired
The boost config to update. Must belong to connectionId and not be archived. Required.
adAccountIdstringoptional
New ad account to spend from, if changing it.
namestringoptional
New name for this preset, if changing it.
targetingobjectoptional
All fields are optional. An empty object targets the platform's broadest default audience.
ageMinnumberoptional
Minimum audience age.
ageMaxnumberoptional
Maximum audience age.
gendersarray of numberoptional
Audience genders to target: 1 for male, 2 for female.
geoLocationsobjectoptional
Geographic targeting: countries, regions, cities, and/or zip codes.
countriesarray of stringoptional
regionsarray of objectoptional
keystringoptional
namestringoptional
citiesarray of objectoptional
keystringoptional
namestringoptional
radiusnumberoptional
distanceUnitstringoptional
zipsarray of objectoptional
keystringoptional
namestringoptional
interestsarray of objectoptional
Interest categories to target.
idstringoptional
namestringoptional
publisherPlatformsarray of stringoptional
Which platform surfaces to target, e.g. ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)optional
Restrict the audience to people who like the page (fans) or their friends too (fans_of_fans).
dailyBudgetnumberoptional
New daily budget, in the platform's minor currency unit, if changing it.
durationDaysnumberoptional
New duration in days, if changing it.
delayHoursnumberoptional
New delay in hours before boosting, if changing it.
publisherPlatformsarray of stringoptional
New list of platform surfaces to boost on, if changing it.
Response
dataobjectoptional
boostConfigobjectoptional
idstringoptional
Unique identifier for the boost config.
connectionIdstringoptional
ID of the connected account this boost config belongs to.
adAccountIdstringoptional
ID of the ad account this boost config spends from.
namestringoptional
Name of this preset.
platformstringoptional
Platform this boost config runs on, matching its connected account.
targetingobjectoptional
Targeting settings for this preset.
ageMinnumberoptional
Minimum audience age.
ageMaxnumberoptional
Maximum audience age.
gendersarray of numberoptional
Audience genders to target: 1 for male, 2 for female.
geoLocationsobjectoptional
Geographic targeting: countries, regions, cities, and/or zip codes.
interestsarray of objectoptional
Interest categories to target.
publisherPlatformsarray of stringoptional
Which platform surfaces to target, e.g. ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)optional
Restrict the audience to people who like the page (fans) or their friends too (fans_of_fans).
dailyBudgetnumberoptional
Daily budget, in the platform's minor currency unit (e.g. cents).
durationDaysnumberoptional
How many days the boost runs once applied.
delayHoursnumberoptional
Hours to wait after a post is published before boosting it.
publisherPlatformsarray of stringoptional
Which platform surfaces this preset boosts on.
archivedbooleanoptional
Whether this preset has been archived.
createdAtstringoptional
When this preset was created, as an ISO 8601 timestamp.
updatedAtstringoptional
When this preset was last updated, as an ISO 8601 timestamp.
adAccountobjectoptional
A short summary of the ad account this preset spends from, or null.
platformAccountIdstringoptional
The platform's own identifier for that ad account.
namestringoptional
Display name of that ad account.
currencystringoptional
Currency that ad account bills in, or null.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/connections/boost-configs/update
Your API key
Request body*
{
  "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"
    }
  }
}