Ein Aufruf nach dem Termin oder der Bestellung, und Citypicked fragt nach der Bewertung. Bewertungen und privates Feedback kommen als Webhook zurück.
Anfrage
POST /v1/requests Authorization: Bearer cp_live_… Idempotency-Key: booking-4711 { "channel": "sms", "consent": true, "contacts": [{ "name": "Lena Hoffmann", "phone": "+491713920012" }] }
Antwort 201
{ "created": 1,
"results": [{ "outcome": "created", "request_id": "…" }] }Webhooks
Abonniere eine URL für die Ereignisse, die du brauchst. Jede Zustellung ist signiert und kommt innerhalb von Sekunden.
Signatur prüfen
Citypicked-Signature: t=1762594200,v1=5f2c… const expected = crypto .createHmac("sha256", secret) .update(`${t}.${rawBody}`) .digest("hex");
Antwortet deine URL nicht mit 2xx, versuchen wir es noch sechsmal, verteilt auf etwa 18 Stunden.
Endpunkte
Lesen geht mit jedem Schlüssel. Senden braucht einen Schlüssel mit dem Recht send.
Vor dem ersten Aufruf
Nichts extra. Lesen geht in jedem Tarif, Senden über die API ab Pro. SMS verbrauchen Guthaben wie in der App, E-Mails keins.
Ja. Mit send_at planst du bis zu 30 Tage im Voraus. Bis dahin kannst du sie mit einem Aufruf abbrechen, etwa wenn ein Termin ausfällt.
Nein. Du kannst Anfragen und Feedback auch abfragen, mit since nur das Neue. Webhooks sparen dir das Abfragen und kommen sofort.
Mit dem Kanal whatsapp bekommst du einen Link zurück. Den öffnet das Team auf dem eigenen Handy und schickt die Nachricht selbst, wie in der App.
Ja, die OpenAPI-3.1-Beschreibung aller Endpunkte, ohne Schlüssel abrufbar.
Deine erste Anfrage ist in fünf Minuten verschickt.