Create or Update Registration ALPHA

Description #

Creates or updates an availability rule for the authenticated account.

URL format #

api.cronofy.com/v1/bookable_events/{bookable_event_id}/registrations

Example Request #

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

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

Example Response #

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

{
  "bookable_event_id": "83hi8qhfiaif",
  "start": "2019-08-24T12:30:00Z",
  "end": "2019-08-24T17:00:00Z",
  "status": "confirmed",
  "registration": {
    "capacity": 5,
    "registered_count": 1,
    "total_count": 1,
    "registrations": [
      {
        "registration_id": "87326",
        "status": "accepted",
        "metadata": {
          "email": "a@company.com",
          "name": "Bill the One",
          "locale": "en-US",
          "zoneinfo": "America/Chicago"
        }
      }
    ]
  }
}

Request parameters #

registration_id required  #

The String that uniquely identifies the registration within the Bookable Event.

Can only contain alphanumeric, underscore or hyphen characters.

status required  #

A String that indicates the status of the registration. Must be one of:

  • pending awaiting confirmation of registration.
  • accepted is confirmed as a registration.
  • tentative is possibly a registration.
  • declined the registration has been declined.
  • removed the registration has been removed.

These deliberately, mostly, map to event invitation status values to support future functionality.

metadata optional  #

Upto 10 key-value pairs of additional data to save against the registration. With the following restrictions.

key
A String of upto 64 characters.
value
A String of up to 256 characters, an Integer, or a Float.

We recommend that, if you wish to store a value that is contained within the Open ID Standard Claims list, you use the key defined in that list. As we extend the capabilities of Bookable Events throughout our service, keys from that list will have the associated meaning.

Response parameters #

The Bookable Event resource. See Read Bookable Event

Search