GET /v1/calendar/staff

The team, and whether each teammate can be booked.

Everyone active in the account’s team, by name, with whether they take bookings. The Calendar’s endpoints name teammates by email.

Needs the calendar:read scope.

Request

cURL

curl "https://api.fireflo.au/v1/calendar/staff" \
  -H "Authorization: Bearer $OMNI_API_KEY"

Response

200 OK — the team, in data. bookable is false for a teammate marked as not taking bookings: they are left out of free times. name is the email when a teammate has no name.

{
  "data": [
    {
      "name": "Anjali Iyer",
      "email": "[e-mail]",
      "bookable": false
    },
    {
      "name": "Priya Sharma",
      "email": "[e-mail]",
      "bookable": true
    },
    {
      "name": "Rahul Verma",
      "email": "[e-mail]",
      "bookable": true
    }
  ]
}

Errors

Every refusal is {"error": {"code", "message", "field"}}; field is there when one input is at fault.

Status	Error code	When
404	module_off	The account’s plan doesn’t include Calendar.
403	scope_missing	The key doesn’t have the calendar:read scope.

Any request can also be refused for its key, its account or its rate (key_required, invalid_key, account_suspended, plan_excludes_api, address_not_allowed, rate_limited); see the overview.