Ignoring Calendar Events

Required plan: Emerging

There are situations where it makes sense to ignore the events in someone’s calendars when generating a list of availabile slots. For example, a recruiter has pre-agreed slots to offer a candidate with a hiring manager, or a sales person needs fit a call in with a client and is happy to override internal meetings.

In these situations you may still want to respect someone’s working hours as defined with Availability Rules or Availability Periods.

This can be achieved by passing an empty array to the participants.members.calendar_ids parameter in the Availability query.

Example Availability Query #

In this example we’re generating slots for 2022-05-24 and respecting the Availability Rules for the participant with sub value of acc_567236000909002.

{
  "participants": [
    {
      "members": [
        {
          "sub": "acc_567236000909002",
          "calendar_ids": [],
          "managed_availability": true
        }
      ],
      "required": "all"
    }
  ],
  "required_duration": { "minutes": 30 },
  "query_periods": [
    {
      "start": "2022-05-24T00:00:00Z",
      "end": "2022-05-25T00:00:00Z"
    }
  ]
}

In this example instead of using Availability Rules we’re manually setting the periods that the participant is available for.

{
  "participants": [
    {
      "members": [
        {
          "sub": "acc_567236000909002",
          "calendar_ids": [],
          "available_periods": [
            {
              "start": "2022-05-24T09:00:00Z",
              "end": "2022-05-24T12:00:00Z"
            },
            {
              "start": "2022-05-24T16:00:00Z",
              "end": "2022-05-24T17:00:00Z"
            }
          ]
        }
      ],
      "required": "all"
    }
  ],
  "required_duration": { "minutes": 30 },
  "query_periods": [
    {
      "start": "2022-05-24T09:00:00Z",
      "end": "2022-05-24T18:00:00Z"
    }
  ]
}