Bookable Events

Today we've enabled our new Bookable Events functionality in Alpha. This allows the creation of events that have a fixed capacity and using them with an Availability query.

Perfect for:

  • Training courses
  • Assessment days
  • Seminars

and many more use cases.

Start by creating an event:

{
  "bookable_event_id": "83hi8qhfiaif",
  "start": "2019-08-20T12:30:00Z",
  "end": "2019-08-20T17:00:00Z",
  "status": "confirmed",
  "registration": {
    "capacity": 5
  }
}

Then add registrations with associated metadata.

{
  "registration_id": "87326",
  "status": "accepted",
  "metadata": {
    "email": "a@company.com",
    "name": "Bill the One",
    "locale": "en-US",
    "zoneinfo": "America/Chicago"
  }
}

And then request availability to discover which events have slots.

{
  "available_bookable_events": [
    {
      "bookable_event_id": "83hi8qhfiaif",
      "start": "2019-08-17T09:00:00Z",
      "end": "2019-08-17T10:00:00Z",
      "registration": {
        "capacity": 5,
        "registered_count": 3
      }
    },
    {
      "bookable_event_id": "jeafugi83gf",
      "start": "2019-08-18T11:00:00Z",
      "end": "2019-08-18T12:00:00Z",
      "registration": {
        "capacity": 5,
        "registered_count": 1
      }
    }
  ]
}

We'll be following up with support for Bookable Events in our UI Elements and Real Time Scheduling features soon.

Review the Bookable Event docs and the extensions to the Availability endpoint.