v1Resources/Clients/postImport Google locations
Import Google locations
Import selected cached locations with the UI workflow. scope=ids (default) requires fetchedListingIds; scope=folder requires folder (null means ungrouped); account scope must be explicit. Exclusions/filter apply within that selection. maxLocations explicitly caps partial import, including zero. The data result includes ok, capacity-refusal reason/counts, already-imported/in-progress counts, batchId and partial dispatch when applicable; HTTP 200 does not imply ok=true or completed imports. notifyByEmail resolves the acting user’s email, never an arbitrary recipient. No internal job handler is exposed.
post
clients:write/api/v1/clients/{id}/google/importQuery parameters
idstringrequired
Request body
connectionIdstringrequired
scopestring (ids | folder | account)optional
fetchedListingIdsarray of stringoptional
folderstringoptional
excludeIdsarray of stringoptional
maxLocationsintegeroptional
filterstringoptional
notifyByEmailbooleanoptional
Response
dataobjectrequired
okbooleanoptional
reasonstring (nothing_selected | nothing_to_import | no_headroom | over_cap)optional
batchIdstringoptional
totalintegeroptional
alreadyImportedintegeroptional
alreadyQueuedintegeroptional
partialbooleanoptional
importableintegeroptional
availableintegeroptional
overintegeroptional
maxLocationsintegeroptional
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.
503The service is temporarily unavailable. Retry a credit grant with the same idempotency key.
post/api/v1/clients/{id}/google/import
Your API key
id *
Request body*
{}Guides that use this resource
- 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.
- Create a Location with the Synup APICreate a business location in one POST, with or without a client, get back a locationId, and know which fields matter and which can wait.
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- 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 Build a White-Label Local Marketing PlatformBuild a multi-tenant white-label local marketing platform on the API, with client provisioning, team access, per-client summaries and scoped API keys.
- 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 Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.