Synup
Create a key
v1Resources/Connections/getList boost configs

List boost configs

Returns the saved boost configurations (reusable targeting and budget presets for boosting a post) on one connected account.

get/api/v1/connections/boost-configs
connections:read
Query parameters
connectionIdstringrequired
The connected account to look up. Required. Look it up with GET /api/v1/connections.
Response
dataobjectoptional
boostConfigsarray of objectoptional
The saved boost configurations on this connected account.
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.
get/api/v1/connections/boost-configs
Your API key
connectionId *
{
  "data": {
    "boostConfigs": [
      {
        "id": "boost_1",
        "connectionId": "conn_1",
        "adAccountId": "adacct_1",
        "name": "Local awareness — $10/day",
        "platform": "facebook",
        "targeting": {
          "ageMin": 25,
          "ageMax": 55,
          "genders": [],
          "geoLocations": {
            "countries": [],
            "regions": [],
            "cities": [],
            "zips": []
          },
          "interests": [],
          "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"
      }
    ]
  }
}