Create a Bookable Event ^ALPHA

Description #

Creates a Bookable Event for the application.

URL format #

api.cronofy.com/v1/bookable_events

Example Request #

POST /v1/bookable_events HTTP/1.1
Host: api.cronofy.com
Authorization: Bearer {API_KEY}
Content-Type: application/json; charset=utf-8

{
  "bookable_event_id": "83hi8qhfiaif",
  "start": "2021-01-31T12:30:00Z",
  "end": "2021-01-31T17:00:00Z",
  "status": "confirmed",
  "registration": {
    "capacity": 5
  }
}

Example Response #

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "bookable_event_id": "83hi8qhfiaif",
  "start": "2021-01-31T12:30:00Z",
  "end": "2021-01-31T17:00:00Z",
  "status": "confirmed",
  "registration": {
    "capacity": 5,
    "registered_count": 0,
    "registrations": []
  }
}

Request Parameters #

bookable_event_id required #

Your application’s unique identifier for the Bookable Event as a String.

Can only contain alphanumeric, underscore or hyphen characters.

start required #

The start time is provided as a simple UTC Time.

end required #

The end time is provided as a simple UTC Time.

status required #

A String status for the event. Must be one of

confirmed
cancelled

registration.capacity required #

An Integer describing the maximum number of registrations that can be accepted by the Bookable Event. Between 1 and 100.

Response Parameters #

See Read Bookable Event endpoint docs.

Cronofy Docs

Create a Bookable Event ALPHA