Retrieve teammate office hours

Request

You can retrieve a teammate's own office hours schedule assignment. An office_hours_schedule_id of null means the teammate has no schedule of their own and inherits office hours instead. This endpoint does not return the inherited schedule.

The teammate must belong to your workspace and be accessible to you. An unknown, malformed, or other-workspace teammate id returns a 422 error, not a 404.

Requires either the read_all or read_write_office_hours OAuth scope and permission to access reporting. Set Intercom-Version: Preview.

Security

bearerAuth

Path

idstringrequired

The unique identifier of the teammate.

Example:456

Intercom-Versionstring(intercom_version_preview)

Preview Intercom API version. Used for closed beta endpoints or other features under managed availability.

Default:"Preview"

Value:"Preview"

Example:Preview

curl -i -X GET \
  https://api.intercom.io/admins/456/office_hours \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

Responses

Teammate office hours assignment

Bodyapplication/json

typestringrequired

The type of the object, always admin_office_hours.

Value:"admin_office_hours"

Example:"admin_office_hours"

admin_idstringrequired

The unique identifier of the teammate.

Example:"456"

office_hours_schedule_idstring or nullrequired

The teammate's own office hours schedule id, or null if they inherit office hours. This is not the id of the inherited schedule.

Example:"123"

Response

{
  "type": "admin_office_hours",
  "admin_id": "456",
  "office_hours_schedule_id": "123"
}