An API (Application Programming Interface) enables two technologies to communicate. Different HTTP methods define what action you want to take with the data.
For example:
GET: Retrieves existing information
POST: Creates something new
PATCH: Modifies existing information
DELETE: Removes existing information
This article covers:
Version 2.0.0
In January 2020, we launched our v2 API. Currently, the API only allows access to event information. However, we plan to include booking data in the future.
✨ You can create an API access token from any Bookwhen account.
API Overview
Our current API allows you to GET certain information from your Bookwhen account. The following data can be accessed:
Events (singular or list)
Locations
Attachments
Tickets
Passes
This means you can display the above public information from your scheduling page on your website, but it’s important to note that this is view-only data.
What the API doesn’t do
The API does not allow for bookings to be made directly. Instead, you'll need to create a button that redirects customers to your Bookwhen site for booking.
Additionally, the API cannot pull this information into your CRM, as it does not support reporting metrics.
Data refresh frequency
You decide how often the API pulls data. Your development team can specify how frequently the information is updated or refreshed by adding additional code to the API.
💡 If you delete a schedule page from your account, it will break the API. After making this change, you’ll need to re-authenticate the API to continue using it.
Difference between API and iframe
The API
Read-only: The API only allows you to GET public data, meaning you cannot make changes.
Doesn’t list attendance: Customer information or attendance data is not accessible via the API.
Event listing: The API only returns events from today and into the future by default.
The iframe
Embed your schedule: The iframe allows you to display your Bookwhen schedule on a separate website.
Browser permissions: You’ll need to grant permission from the browser to use the iframe on your site.
Reflects your Bookwhen schedule: The iframe shows an exact copy of your Bookwhen schedule, with no additional edits.
No cookies: Unlike other integrations, the iframe does not use cookies.
Version 1.0.0 (deprecated)
Our v1 API is now deprecated. If you require a v1 API access key for your account, please email support@bookwhen.com with your account link.
💬 Need extra help?
For the quickest response, contact us via live chat on our homepage or your account. Buddy, our trusty chatbot, will assist first and pass you to a support team member if needed.
Prefer email? Send us an email instead.
Thank you! 🕺