Booking API
The Aurinko Booking API automates meeting scheduling, enabling developers to access calendar availability and create booking profiles easily.
Last updated
The Aurinko Booking API automates meeting scheduling, enabling developers to access calendar availability and create booking profiles easily.
Last updated
The Booking API is a powerful tool designed to facilitate the automated scheduling of meetings for one calendar. It enables developers to gather availability information from a calendar and find time slots when the calendar owner is available.
The API is built on top of the Aurinko Account concept. Please see section to understand how to add an account and get access to its calendars.
At the heart of the lies a booking/availability profile. This profile consists of a set of properties that describe calendar availability and the types of meetings that can be booked. It includes the following information:
Work hours
Meeting duration
Meeting subject
Meeting description
Meeting teleconference link
Meeting location
Profile scheduler link
Profile active period
And more...
You can insert variables like {{name}}
, {{comments}}
in the meeting description text. They will be passed to a scheduling widget to be filled by an end user booking a meeting (see additionalFields
of the availability endpoint below).
Use PATCH request to update existing profiles:
curl -X GET
https://api.aurinko.io/v1/book/account/profiles/{id}/meeting
The additionalFields
array contains the {{variables}}
that you specified in the meeting description text. If you're building your own scheduling widget it needs to ask the end user for those inputs. Booking a meeting will require the fields that don't specify defaults.
Book a meeting by sending json payload to the
book/account/profiles/{id}/meeting
endpoint:
A new event will be created on the calendar associated with the booking profile and the person specified by the email and name fields will be invited to the event.
To create a new booking profile POST json payload to the endpoint:
Once a booking profile is created, the can be used to query a user's availability for the types of meetings defined in the profile and within the specified work hours. ) can be used to query a user's availability for the types of meetings defined in the profile and within the specified work hours.
This endpoint produces information that can be used to build a public calendar page like .