v1Resources/Connections/postGet Google listing creation status
Get Google listing creation status
Returns where Google listing creation stands for each location, read from the location's Google connection and its latest Google create order. Call it after create and poll until each location reaches created or failed. Location ids you can't access come back in unavailableIds. Up to 200 locations per request.
post
connections:read/api/v1/connections/google-listing-create/statusRequest body
locationIdsarray of stringrequired
The ids of the locations to work on, up to 200. Duplicates are ignored.
Response
dataobjectoptional
statusesarray of objectoptional
One entry for each requested location you can access.
locationIdstringoptional
The location's id.
statestring (none | queued | creating | retrying | failed | created)optional
none (no Google create for this location), queued (waiting to start), creating (in progress), retrying (the last attempt failed and will run again), failed (stopped and won't finish on its own) or created (the location is linked to a Google listing).
orderItemIdstringoptional
The location's latest Google create order. Absent when there isn't one.
orderItemStatusstring (PENDING | IN_PROGRESS | COMPLETED | FAILED | CANCELED | AUTO_FAILED | SKIPPED)optional
The raw status of that order. Absent when there isn't one or when state is created.
issueCategorystringoptional
A category code for what went wrong on the latest attempt, or null. Absent when state is none or created.
reasonstringoptional
A readable explanation of why the latest attempt failed, or null. Absent when state is none or created.
unavailableIdsarray of stringoptional
Requested location ids that weren't found or that you can't access. They are listed here instead of failing the request.
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.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/connections/google-listing-create/status
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.