Booking API quick start in 5 steps
A token, a first call, your event types, a free slot, a booking. All with curl, in a few minutes.
This booking API quick start takes you from a token to your first booking. You need an Artibox Calendar account on the Pro plan or above, an active event type and a terminal with curl.
export RDV_API="https://your-application-domain/api/v1"
export RDV_TOKEN="rdv_pat_…"The exact API address is at the top of the API reference: the application's domain followed by /api/v1.
Step 1: create a personal token
In the app, open Settings › Integrations, « API » card. Name the token, optionally set an expiry date, and tick the scopes this guide needs: utilisateur:lire, types:lire and reservations:ecrire. Copy the token at once: it starts with rdv_pat_ and is never shown again.
Step 2: your first call
curl "$RDV_API/me/context" -H "x-api-key: $RDV_TOKEN"Every response uses the same envelope: message, data, errors. A missing or refused token answers 401; a missing scope, 403. See limits, errors and pagination.
Step 3: list your event types
curl "$RDV_API/types" -H "x-api-key: $RDV_TOKEN"Each type has its id, name, duration_minutes, mode (video, phone, in_person) and format. Keep the id of the type you want to book.
Step 4: find a free slot
Slots are computed as on the booking page: hosts' hours, connected calendars, buffers, notice and daily maximum. Pass a period in ISO 8601 with an offset (encode + as %2B):
curl "$RDV_API/types/TYPE_ID/slots?from=2026-12-01T00:00:00%2B01:00&to=2026-12-08T00:00:00%2B01:00" \
-H "x-api-key: $RDV_TOKEN"Step 5: book the slot
curl -X POST "$RDV_API/bookings" \
-H "x-api-key: $RDV_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"type_id":"TYPE_ID","start":"2026-12-01T10:00:00+01:00","name":"Camille Martin","email":"camille.martin@example.com","timezone":"Europe/Paris","locale":"en"}'The 201 response holds the booking, with origin api; the guest gets the usual confirmation. If the slot was taken meanwhile, the call is refused: read the slots again. Replayed within 24 hours with the same Idempotency-Key, the call returns the first response without creating a duplicate.
After this booking API quick start
Get notified with webhooks, act for other accounts with OAuth 2 and PKCE, and browse every route in the API reference.
Make your first call
Create your account, then your token in Settings › Integrations.
Create my account