Getting started
Before you start, explore the 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:
- Search employee calendars — 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):
| Data type / method | Permission |
|---|---|
| Search calendar events | Settings > Calendar > Manage company calendar Scope: |
| Search Employee Calendars | Settings > Calendar > Manage company calendar AND People's fields > Employment > View employment sections timeoff.calendars:write AND employee_data:read. |
To learn more about setting permissions for service users, see 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.
| Method | Endpoint | Limit per minute |
|---|---|---|
| POST | Search calendar events | 100 |
| POST | Search Employee Calendars |
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 |
| Search Employee Calendars | Search Employee Calendars |