IntegrationsAPI
One call after the appointment or the order, and Citypicked asks for the review. Ratings and private feedback come back as webhooks.
Request
POST /v1/requests Authorization: Bearer cp_live_… Idempotency-Key: booking-4711 { "channel": "sms", "consent": true, "contacts": [{ "name": "Emma Clark", "phone": "+12015550123" }] }
Response 201
{ "created": 1,
"results": [{ "outcome": "created", "request_id": "…" }] }Webhooks
Subscribe a URL to the events you need. Every delivery is signed and arrives within seconds.
Check the signature
Citypicked-Signature: t=1762594200,v1=5f2c… const expected = crypto .createHmac("sha256", secret) .update(`${t}.${rawBody}`) .digest("hex");
If your URL does not answer with a 2xx, we try six more times over about 18 hours.
Endpoints
Reading works with any key. Sending needs a key with the send scope.
Before the first call
Nothing extra. Reading works on every plan, sending through the API from Pro. Texts use credits as in the app, emails none.
Yes. With send_at you schedule up to 30 days ahead. Until then one call cancels it, for example when an appointment falls through.
No. You can also fetch requests and feedback, with since for only what is new. Webhooks save you the polling and arrive at once.
With the channel whatsapp you get a link back. The team opens it on its own phone and sends the message itself, as in the app.
Yes, the OpenAPI 3.1 description of every endpoint, available without a key.
Your first request goes out in five minutes.