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.
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 | Comment |
|---|---|---|
| Search calendar events | Settings > Calendar > Manage company calendar Scope: | If missing, the API returns 403 Forbidden with an explanation. |
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 |
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 | Search calendar events |