IntégrationsAPI
Un appel après le rendez-vous ou la commande, et Citypicked demande l’avis. Les notes et les retours privés reviennent sous forme de webhooks.
Requête
POST /v1/requests Authorization: Bearer cp_live_… Idempotency-Key: booking-4711 { "channel": "sms", "consent": true, "contacts": [{ "name": "Emma Leclerc", "phone": "+12015550123" }] }
Réponse 201
{ "created": 1,
"results": [{ "outcome": "created", "request_id": "…" }] }Webhooks
Abonne une URL aux événements dont tu as besoin. Chaque envoi est signé et arrive en quelques secondes.
Vérifier la signature
Citypicked-Signature: t=1762594200,v1=5f2c… const expected = crypto .createHmac("sha256", secret) .update(`${t}.${rawBody}`) .digest("hex");
Si ton URL ne répond pas avec un 2xx, nous réessayons six fois de plus sur environ 18 heures.
Endpoints
La lecture fonctionne avec n’importe quelle clé. L’envoi demande une clé avec le droit d’envoi.
Avant le premier appel
Rien de plus. La lecture fonctionne avec toutes les formules, l’envoi via l’API à partir de Pro. Les SMS consomment des crédits comme dans l’application, les e-mails n’en consomment pas.
Oui. Avec send_at, tu planifies jusqu’à 30 jours à l’avance. D’ici là, un appel suffit pour l’annuler, par exemple quand un rendez-vous tombe à l’eau.
Non. Tu peux aussi récupérer les demandes et les retours, avec since pour n’avoir que les nouveautés. Les webhooks t’évitent d’interroger l’API sans cesse et arrivent tout de suite.
Avec channel réglé sur whatsapp, tu reçois un lien en retour. L’équipe l’ouvre sur son propre téléphone et envoie elle-même le message, comme dans l’application.
Oui, la description OpenAPI 3.1 de chaque endpoint, accessible sans clé.
Ta première demande part dans cinq minutes.