Google Business Profile API

Google Business Profile Hours API

Update regular hours, special hours, and extra hour sets for Google Business Profile locations without turning holiday changes into spreadsheet archaeology.

Last updated: May 2026

Dedicated endpoint for hour-only updates

Supports regularHours, specialHours, and moreHours

Useful for agencies, franchises, restaurants, clinics, retail chains, and local SaaS dashboards

What the hours workflow manages

This workflow is for hour changes only: weekly opening hours, date-specific exceptions, and additional hour groups such as pickup or department-specific hours. Use it when your product needs a focused hours editor instead of a full location profile patch.

Endpoint and payload shape

Use PATCH /api/v1/misc/google-business/location/hours. The payload must include teamId and a fields array containing one or more of regularHours, specialHours, or moreHours. The matching hour blocks are then sent to Google. You can also include validateOnly: true to check the request before applying it.

Where teams usually get stuck

The annoying part is not the HTTP call. It is keeping field selection aligned with the payload. If fields includes specialHours but the body does not include specialHours, your UI is lying to the operator. The same goes the other way around: do not silently send hours sections that were not intentionally selected.

Real product use cases

Use this page for dashboards that update Christmas hours, public holiday closures, short-term reopening windows, pickup hours, restaurant service hours, or local branch opening times across many locations. It is also useful for approval flows where an operator previews hour changes before they are sent to Google.

How bundle.social fits

bundle.social keeps Google Business Profile hours near posts, reviews, media, account operations, and the rest of your social publishing stack. Your app can build one local profile management workflow instead of maintaining a separate one-off integration just for business hours.

Bundle Social and official references

Platform APIs change. Use these links to confirm current error behavior and field support.

FAQ

Should I use the hours endpoint or the location endpoint?

Use the hours endpoint when you only change regularHours, specialHours, or moreHours. Use the location endpoint when you also need to update profile fields such as title, website, phone numbers, categories, address, service area, or coordinates.

Can I update holiday hours without changing weekly hours?

Yes. Send fields with specialHours and include only the specialHours block. Do not include regularHours unless you are intentionally changing the weekly schedule too.

Can I validate the hours before applying them?

Yes. Include validateOnly: true when you want Google to validate the request without persisting the change.

Build with less platform drag

Use one API for social publishing workflows

Create account