Synup
Create a key
v1Resources/Connections/postAssign a listing to a location

Assign a listing to a location

Pairs an already-connected account's already-fetched listing to a location with no connection of its own yet. Not a fresh OAuth grant — caId must already be a connected account; this reuses that login. Google and Facebook only.

post/api/v1/connections/locations/assign
connections:write
Request body
platformstring (google | facebook)required
The platform: google or facebook. Required.
caIdstringrequired
The already-connected account to pair. Required.
locationIdstringrequired
The location to assign this listing to. Required.
platformResourceNamestringrequired
The listing's resource name/id on the platform. Required.
platformPageNamestringrequired
The listing's display name on the platform. Required.
Response
dataobjectoptional
idstringoptional
Unique identifier for the resulting connection.
platformstring (google | facebook)optional
The platform the listing was paired on.
synupLocationIdstringoptional
The location's legacy Synup id, or null for a native location.
clientLocationIdstringoptional
The location's id.
platformResourceNamestringoptional
The listing's resource name/id on the platform.
platformPageNamestringoptional
The listing's display name on the platform.
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/locations/assign
Your API key
Request body*
{
  "data": {
    "id": "listing_1",
    "platform": "google",
    "synupLocationId": null,
    "clientLocationId": "loc_456",
    "platformResourceName": "accounts/123/locations/456",
    "platformPageName": "Acme Dental — Downtown"
  }
}