Skip to content

Get started as a developer

The ways to take bookings on your own website, from a link to your own screens, the addresses to use, and your first request to the public booking API.

Tutorial3 min read

Booking Orbit keeps your locations, services, people and free times. As a developer you can let customers book from your own website or app, in the hosted booking screens or in your own design, and let AI assistants work with appointments for your team.

What to use for what

Send customers to a ready booking page
Use
A link to the location's booking page, such as https://app.bifrostorbit.com/booking/b/northwilds-oslo
Needs
Nothing
Show the booking screens inside your own page, or in a popup
Needs
Nothing. It works on any website.
Build booking screens in your own design
Use
The Booking SDK for JavaScript and TypeScript, or the public booking API from any language
Needs
Your website under Settings › Your website to book from the browser
Show services and free times on a website built with CMS Orbit
Use
The Booking Orbit blocks in CMS Orbit. See Appointments from Booking Orbit.
Needs
The space connected under Linked satellites
Count bookings in Insights Orbit, or ask for reviews afterwards in Presence Orbit
Use
Events that Booking Orbit sends through Orbit Exchange
Needs
Nothing to build
Let an AI assistant find free times and book
Use
Needs
The assistant connected under AI assistants

The public booking API needs no key. Reading services and free times works from anywhere; holding a time and booking work from your server and from the websites you allow. See Allowed websites.

Addresses

Booking Orbit
Production
https://app.bifrostorbit.com/booking
Staging
https://stage.bifrostorbit.com/booking
Public booking API
Production
https://app.bifrostorbit.com/booking/api/public/<location>
Staging
https://stage.bifrostorbit.com/booking/api/public/<location>
Widget script
Production
https://app.bifrostorbit.com/booking/widget.js
Staging
https://stage.bifrostorbit.com/booking/widget.js

<location> is the last part of the location's booking page address, such as northwilds-oslo. Find it under Booking page. Admins change it under Settings › Short name; old addresses then stop working, so change it before you build. Each location is booked on its own, so a website for three shops uses three addresses.

Your first request

Three requests take a booking. You can run them from a terminal, as here, or from your server.

1List the services

Shell
curl "https://app.bifrostorbit.com/booking/api/public/northwilds-oslo/services"
JSON
{  "data": {    "services": [      {        "id": "6ae6548e8e80975012f97d3e",        "slug": "boot-fitting",        "name": "Boot fitting",        "durationMinutes": 45,        "mode": "in-person",        "price": { "kind": "fixed", "amount": 45000 },        "payment": { "rule": "none", "depositAmount": null },        "staffIds": ["…", "…"]      }    ]  }}

Prices are in the currency's smallest unit: 45000 is NOK 450.

2Find a free time

Shell
curl "https://app.bifrostorbit.com/booking/api/public/northwilds-oslo/slots?service=boot-fitting&days=7&timeZone=Europe/Oslo"

The answer lists every day in the time zone you asked for, each with its free times, and next, the first free time even beyond those days.

3Hold it and book

Holding keeps the time for 10 minutes while the customer types their details. Then book with the hold's token:

Shell
curl -X POST "https://app.bifrostorbit.com/booking/api/public/northwilds-oslo/holds" \  -H "Content-Type: application/json" \  -d '{ "service": "boot-fitting", "startsAt": "2026-11-12T09:45:00.000Z" }'curl -X POST "https://app.bifrostorbit.com/booking/api/public/northwilds-oslo/appointments" \  -H "Content-Type: application/json" \  -d '{ "service": "boot-fitting", "startsAt": "2026-11-12T09:45:00.000Z", "holdToken": "…", "name": "Ingrid Berg", "email": "ingrid@northwilds.com", "timeZone": "Europe/Oslo" }'

The answer has the appointment's reference, such as 29BMJM, and its manageUrl, where the customer can move or cancel it. Booking Orbit emails the confirmation and the reminders, as it does for the booking page.

A booking is real: try it against a location of your own, and cancel it afterwards with POST/manage/<token>/cancel.

Next steps

Was this page helpful?

Read next