Skip to main content
Use this endpoint when you only need to change opening hours (regular weekly hours, special dates, or additional hour types). It updates the same Google location resource as Location & profile, but requires an explicit fields array so the API knows which hour sections are part of your update payload. Endpoint: PATCH /api/v1/misc/google-business/location/hours Base path: /api/v1/misc/google-business

​
Body rules

FieldRequiredDescription
teamIdYesTeam with a connected Google Business location.
fieldsYesWhich hour sections this update payload applies to. Each value must be one of: regularHours, specialHours, moreHours. You can pass one or more (comma-separated or repeated style, same as other query lists in this API).
regularHoursOptionalWeekly schedule. Omit if not in fields.
specialHoursOptionalDate-specific overrides. Omit if not in fields.
moreHoursOptionalArray of extra hour groups (for example pickup). Omit if not in fields.
validateOnlyOptionalIf true, validation only, no persist.
You must include at least one hour block that matches fields. The server forwards the update payload to Google.

​
Time and day shapes

Weekdays for openDay / closeDay in periods: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY Time can be sent as:
  • A string like "09:00" or "09:00:00" (normalized to Google’s time-of-day object where supported), or
  • An object: hours, minutes, optional seconds, optional nanos.
Special hours periods may include startDate / endDate with year, month, day, plus openTime, closeTime, and closed: true when the location is closed all day.

​
Example: full hours update payload (anonymized)

teamId is a placeholder. Structure matches a real multi-section hours update payload: regular week, holiday exceptions, and moreHours with a type id (use values Google returns for your location for hoursTypeId). 
{
  "teamId": "00000000-0000-4000-8000-000000000001",
  "fields": ["regularHours", "specialHours", "moreHours"],
  "regularHours": {
    "periods": [
      {
        "openDay": "MONDAY",
        "openTime": "10:00",
        "closeDay": "MONDAY",
        "closeTime": "18:00"
      },
      {
        "openDay": "TUESDAY",
        "openTime": "10:00",
        "closeDay": "TUESDAY",
        "closeTime": "18:00"
      },
      {
        "openDay": "WEDNESDAY",
        "openTime": "10:00",
        "closeDay": "WEDNESDAY",
        "closeTime": "18:00"
      },
      {
        "openDay": "THURSDAY",
        "openTime": "10:00",
        "closeDay": "THURSDAY",
        "closeTime": "18:00"
      },
      {
        "openDay": "FRIDAY",
        "openTime": "10:00",
        "closeDay": "FRIDAY",
        "closeTime": "18:00"
      },
      {
        "openDay": "SATURDAY",
        "openTime": "10:00",
        "closeDay": "SATURDAY",
        "closeTime": "15:00"
      }
    ]
  },
  "specialHours": {
    "specialHourPeriods": [
      {
        "startDate": { "year": 2026, "month": 12, "day": 24 },
        "endDate": { "year": 2026, "month": 12, "day": 24 },
        "openTime": "10:00",
        "closeTime": "14:00",
        "closed": false
      },
      {
        "startDate": { "year": 2026, "month": 12, "day": 25 },
        "endDate": { "year": 2026, "month": 12, "day": 25 },
        "closed": true
      }
    ]
  },
  "moreHours": [
    {
      "hoursTypeId": "PICKUP",
      "periods": [
        {
          "openDay": "MONDAY",
          "openTime": "10:00",
          "closeDay": "MONDAY",
          "closeTime": "18:00"
        },
        {
          "openDay": "TUESDAY",
          "openTime": "10:00",
          "closeDay": "TUESDAY",
          "closeTime": "18:00"
        },
        {
          "openDay": "WEDNESDAY",
          "openTime": "10:00",
          "closeDay": "WEDNESDAY",
          "closeTime": "18:00"
        },
        {
          "openDay": "THURSDAY",
          "openTime": "10:00",
          "closeDay": "THURSDAY",
          "closeTime": "18:00"
        },
        {
          "openDay": "FRIDAY",
          "openTime": "10:00",
          "closeDay": "FRIDAY",
          "closeTime": "18:00"
        },
        {
          "openDay": "SATURDAY",
          "openTime": "10:00",
          "closeDay": "SATURDAY",
          "closeTime": "15:00"
        }
      ]
    }
  ]
}