v1Resources/Connections/postMove a listing account to agency level
Move a listing account to agency level
Moves a client's Google or Facebook listing account up to agency level, so its listings can be assigned to locations of any client in your agency. Nothing reconnects and no one signs in again: the locations the account already serves stay connected through the same sign-in. If your agency already has an agency-level account for the same Google or Facebook sign-in, this one merges into it. Its listings and ad accounts move to the existing account, and the account you moved is archived. Send dryRun as true first to see what would happen without changing anything. This needs a token with access to every client; a token limited to specific clients gets 403. Returns 400 for anything other than a Google or Facebook listing account (brand-level social accounts and a single location's connection can't move), 404 when the connection doesn't exist or is archived, and 409 when the account is already at agency level.
post
connections:write/api/v1/connections/move-to-agencyRequest body
connectionIdstringrequired
The id of the listing account to move. Use the account's own connection, not the connection of one of its locations.
dryRunbooleanoptional
Set to true to preview the move without making it. The response has the same fields, minus moved.
Response
dataobjectoptional
movedboolean (true)optional
Always true after a real move. Not included in a dry run.
accountIdstringoptional
The account you asked to move. After a merge, this account is archived and mergeIntoId is the account to use from then on.
mergeIntoIdstringoptional
The existing agency-level account this one merges into, or null when the account moves on its own.
mergeIntoNamestringoptional
The display name of the account it merges into, or null when there is no merge.
locationCountintegeroptional
How many connected locations the account serves, counted before the move.
clientCountintegeroptional
How many clients those locations belong to.
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.
409The request conflicts with the current state of the resource — for example, changing the email or phone of a recipient who has already been messaged, or a team invite that was already accepted (or hasn't been accepted yet).
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/connections/move-to-agency
Your API key
Request body*
{}Guides that use this resource
- What Is a Business Listings API?A business listings API manages a business's name, address, hours and more across many publishers at once, with sync status and duplicate detection built in.
- Business Listings API: Complete Developer GuideHow a business listings API works and how to create, update, sync and monitor locations across Google, Apple, Bing and directories with the Synup API.
- Google Business Profile API vs a Listings Management APIHow Google's Business Profile API compares with a listings management API on scope, access, sync status, duplicates and reviews, and when to use each.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Update Business Information Across Google, Apple, Bing and DirectoriesPush one business-information change to Google, Apple, Bing and the directory network through a single API call, and verify it reached each publisher.
- How to Manage Thousands of Business Locations via APIDesign a sync job for thousands of locations on the Synup API with cursor pagination, tags, rate-limit handling, an id map and rollup health checks.
- How Google Business Profile Synchronization WorksGoogle Business Profile sync rests on an owner's OAuth consent, matching a location to the right Google listing, then a write-and-verify loop.
- How to Build a Multi-Location Marketing DashboardBuild a multi-location marketing dashboard from the API's rollup endpoints, one call per panel, covering listings, reviews, rank, AI visibility and duplicates.
- How to Connect and Manage Google Business Profiles via APIConnect a Google Business Profile to a location, match the account's listings, keep the profile in sync and handle reconnects with the Synup API.
- Building Publisher Integrations Directly vs Using SynupWhat it really costs to integrate Google, Apple, Bing and directories yourself, versus one API, and how to decide between them or combine both.