---
updatedAt: 2026-07-21T13:47:09.000Z
---

Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.

# Calendar events

# Getting started

Before you start, [explore the Time off API](/docs/explore-time-off-api) to see how Bob models time off, sites, and calendars.

The **Calendar events** API exposes read-only company calendar data so integrations (for example Google Calendar or Outlook) can **align external systems with Bob** instead of maintaining duplicate holiday and closure lists.

Use these endpoints together:

1. **[Search employee calendars](https://apidocs.hibob.com/reference/post_timeoff-calendars-employees-search)** — bulk-resolve which holiday calendar applies to each employee (employment override vs site default).

# Required permissions

The authenticated service user must be allowed to read company calendar configuration and related time off settings. Grant the following in Bob (paths reflect the admin permission UI):

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Data type / method
      </th>

      <th>
        Permission
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Search calendar events
      </td>

      <td>
        Settings > Calendar > Manage company calendar

        Scope: `timeoff.calendars:write`
      </td>
    </tr>

    <tr>
      <td>
        Search Employee Calendars
      </td>

      <td>
        Settings >  Calendar > Manage company calendar AND<br />People's fields >  Employment > View employment sections<br /><br />`timeoff.calendars:write` AND `employee_data:read`.
      </td>
    </tr>
  </tbody>
</Table>

To learn more about setting permissions for service users, see [API Service Users](https://apidocs.hibob.com/docs/api-service-users).

# Rate limiting

Rate limits restrict how often your integration can call Bob's APIs within a time window. For background and headers, see [Rate limiting](https://apidocs.hibob.com/docs/rate-limit).

| Method | Endpoint                                                                                                 | Limit per minute |
| :----- | :------------------------------------------------------------------------------------------------------- | :--------------: |
| POST   | [Search calendar events](https://apidocs.hibob.com/reference/post_timeoff-calendars-events-search)       |        100       |
| POST   | [Search Employee Calendars](https://apidocs.hibob.com/reference/post_timeoff-calendars-employees-search) |                  |

The limit applies **per company** (not per user). If you exceed it, responses use `429 Too Many Requests`; back off using the rate-limit headers described in the rate limiting guide.

# Calendar events endpoints

| Resource                  | Endpoint                                                                                                 |
| :------------------------ | :------------------------------------------------------------------------------------------------------- |
| Search calendar events    | [Search calendar events](https://apidocs.hibob.com/reference/post_timeoff-calendars-events-search)       |
| Search Employee Calendars | [Search Employee Calendars](https://apidocs.hibob.com/reference/post_timeoff-calendars-employees-search) |

<br />