Google Business · Google Business Location Details
Updates location details.
PUT
https://api.pozy.ai/v1/accounts/{accountId}/gmb-location-detailsupdateGoogleBusinessLocationDetails
Guide: Location details
Request
Send your API key as Authorization: Bearer pz_live_.... Read-only keys cannot call it. Keys with the accounts resource group disabled get 403 resource_group_disabled. Authentication
Path parameters
| Name | Type | Notes |
|---|---|---|
accountIdrequired | string |
Query parameters
| Name | Type | Notes |
|---|---|---|
locationId | string |
Request body
application/json, required
updateMaskstringrequiredregularHoursobjectperiodsarray of object4 child fields
openDaystringopenTimestringcloseDaystringcloseTimestring
specialHoursobjectspecialHourPeriodsarray of object5 child fields
startDateobject3 child fields
yearintegermonthintegerdayinteger
endDateobject3 child fields
yearintegermonthintegerdayinteger
openTimestringcloseTimestringclosedboolean
profileobjectdescriptionstring
websiteUristringphoneNumbersobjectprimaryPhonestringadditionalPhonesarray of string
categoriesobjectprimaryCategoryobject1 child field
namestring
additionalCategoriesarray of object1 child field
namestring
serviceItemsarray of objectstructuredServiceItemobject2 child fields
serviceTypeIdstringdescriptionstring
freeFormServiceItemobject2 child fields
categorystringlabelobject2 child fields
displayNamestringlanguageCodestring
priceobject3 child fields
currencyCodestringunitsstringnanosinteger
titlestringstoreCodestringlabelsarray of stringstorefrontAddressobjectregionCodestringlanguageCodestringpostalCodestringadministrativeAreastringlocalitystringaddressLinesarray of string
serviceAreaobjectbusinessTypestringOne of
CUSTOMER_LOCATION_ONLY,CUSTOMER_AND_BUSINESS_LOCATION.placesobject1 child field
placeInfosarray of object2 child fields
placeNamestringplaceIdstring
regionCodestring
openInfoobjectstatusstringOne of
OPEN,CLOSED_PERMANENTLY,CLOSED_TEMPORARILY.openingDateobject3 child fields
yearintegermonthintegerdayinteger
moreHoursarray of objecthoursTypeIdstringperiodsarray of object4 child fields
openDaystringopenTimestringcloseDaystringcloseTimestring
latlngobjectlatitudenumberlongitudenumber
adWordsLocationExtensionsobjectadPhonestring
Example
curl -X PUT "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/gmb-location-details" \
-H "Authorization: Bearer $POZY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"updateMask": "2026-10-02T09:00:00.000Z"
}'const res = await fetch("https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/gmb-location-details", {
method: "PUT",
headers: {
Authorization: `Bearer ${process.env.POZY_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
updateMask: "2026-10-02T09:00:00.000Z"
}),
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);import os
import requests
resp = requests.put(
"https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/gmb-location-details",
headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
json={
"updateMask": "2026-10-02T09:00:00.000Z",
},
timeout=30,
)
resp.raise_for_status()
print(resp.json())Response
200 on success
successbooleanaccountIdstringlocationIdstring
200 response
{
"success": true,
"accountId": "696e0b682d0a31188e7a2ba9",
"locationId": "6e99c3dd69982b334a43b0b2"
}Errors
Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:
| 400 | invalid_request_error | A parameter or body field is missing or invalid. param names it. |
| 401 | authentication_error | The API key is missing, revoked or expired. |
| 403 | permission_error | The key is read-only, scoped to other profiles, or has this resource group disabled. |
| 404 | not_found | Nothing with that id exists in your workspace. |
| 429 | rate_limit_error | Too many requests this minute. Wait for Retry-After seconds. |
Every code is listed in Errors.