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: timeoff.calendars:write

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