Skip to content

Single-use and signed links · API reference

Single-use booking links and signed links carrying a context (11.8).

Create a single-use link

POST/types/{id}/unique-links

Scope : liens:ecrire Create single-use links, signed links and link sends

Creation: the Idempotency-Key header prevents duplicates for 24 hours.

Parameters

NameInTypeRequiredDescription
idpathstringyes
Idempotency-KeyheaderstringnoUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Request body

`{days?: 1–90 (14), note?}` — l'adresse n'est donnée qu'ici

Request example
curl -X POST 'https://www.artibox-calendar.com/api/v1/types/{id}/unique-links' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{"days":14,"note":"Relance devis 2026-118"}'

Responses

  • 201 Created
  • 401 Missing, unknown or expired token
  • 403 Missing scope or right refused
  • 404 Not found (or another organisation's)
  • 409 Conflict: slot taken or request in progress
  • 422 Data refused: details are given field by field
  • 429 Too many calls: wait for Retry-After

Create a signed link with a context

POST/types/{id}/signed-links

Scope : liens:ecrire Create single-use links, signed links and link sends

Creation: the Idempotency-Key header prevents duplicates for 24 hours.

Parameters

NameInTypeRequiredDescription
idpathstringyes
Idempotency-KeyheaderstringnoUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Request body

11.6 : `{source, type, id, libelle?, prerempli?: {nom, email, telephone}, organisateur?, days?: 1–90 (14)}` — signé avec la clé de contexte de l'organisation (11.8)

Request example
curl -X POST 'https://www.artibox-calendar.com/api/v1/types/{id}/signed-links' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{"source":"mon-crm","type":"affaire","id":"AFF-2026-0042","libelle":"Projet Dupont","prerempli":{"nom":"Camille Martin","email":"camille.martin@example.com"},"days":14}'

Responses

  • 201 Created
  • 401 Missing, unknown or expired token
  • 403 Missing scope or right refused
  • 404 Not found (or another organisation's)
  • 409 Conflict: slot taken or request in progress
  • 422 Data refused: details are given field by field
  • 429 Too many calls: wait for Retry-After