listingsAPIlistingsAPI
Get API keySign in
POST/api/v4/locations/create/gmb-listing

Create a GMB listing for a location

Creates a new Google Business Profile listing for an existing listingsAPI location and links it to a connected Google account.

Requires an API key. See Authentication for header format and key rotation.

Parameters

Body

NameTypeRequiredDescription
locationIdstringrequiredBase64-encoded location Relay ID (e.g. TG9jYXRpb246MTgwMDI4OQ==), or the raw numeric location ID.
connectedAccountIdstringrequiredUUID of the connected Google account the new listing should be created under.

Sample request

Ready-to-paste body. Replace placeholder IDs and values with yours.

{
  "locationId": "TG9jYXRpb246MTgwMDI4OQ==",
  "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5"
}

Responses

200GMB listing creation initiated.
{
  "data": {
    "createGmbListingForLocation": {
      "success": true,
      "errors": null
    }
  }
}
400Bad request — location missing required fields, listing already exists, or account not active.
401Unauthenticated — missing or invalid API key.

Creates a brand-new Google Business Profile listing for a listingsAPI location and associates it with a connected Google account. Use this when the location does not yet have a Google listing at all — as opposed to connect-listing, which links a listingsAPI location to a listing that already exists in the Google account.

Creation is asynchronous: success: true means the request was accepted, not that the listing is instantly live. Google reviews new profiles before they publish. The locationId accepts either the base64-encoded Relay ID or the raw numeric ID.

Use case — provisioning Google presence for a net-new storefront. A client opens a new location that has no Google Business Profile yet. Create the listingsAPI location, connect the client's Google account, then call this endpoint with the location's ID and the connectedAccountId to have listingsAPI submit the new listing to Google under that account. Poll the location's listings afterward to watch it move from pending to verified.

The location must already carry valid business information (name, address, phone) before a listing can be created, and only one Google listing can exist per location. On failure errors explains why — typically the location is missing required fields, already has a Google listing, is archived, or the connected account is not active. Reconnect a stale account with the connect-google endpoint.

curl -X POST 'https://listingsapi.com/api/v4/locations/create/gmb-listing' \
  -H "Authorization: API $LISTINGSAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "locationId": "<locationId>",
    "connectedAccountId": "<connectedAccountId>"
  }'
Run in playground