Skip to content

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