Connect contacts, appointments, conversations and calls to your own CRM or practice software. For real-time events, add a signed webhook under Settings › Integrations › Webhooks.
The ZILKO REST API connects your business’s contacts, appointments, conversations and calls to your own CRM, practice software or automation tool. Requests and responses are JSON; all times are ISO 8601 in UTC.
In the panel, create a key under Settings › Integrations › Developer API. Choose “Read and write” access if you will create contacts or appointments. /clinic/settings?tab=integrations
Send the key in the Authorization header with every request and call the endpoints below.
Add a signed webhook to hear about new contacts, appointments and calls the moment they happen.
Every request carries the key as a Bearer token. A key only sees its own business’s data and is shown in full only once, when created. If a key is lost or leaked, revoke it in the panel and create a new one.
Authorization: Bearer zk_live_…
Scope
Allows
read
GET endpoints: contacts, appointments, free slots, team, conversations, calls.
write
In addition to read, POST and PATCH: adding and updating contacts, notes, creating and updating appointments.
Keys do not work in demo accounts (409 DEMO_MODE); they start working once the account is activated.
Base URL
https://zilko.co/api/v1
All paths are relative to this URL. Only HTTPS is accepted.
Rate limit
120 requests per minute per key. Above the limit the API returns 429 RATE_LIMITED; wait a moment and retry. For bulk syncs, fetch only what changed with updatedSince.
Errors
Error responses always share the same envelope. code is for machines, message for people; for validation errors, fields tells you which field is invalid and why.
The key’s scope is not enough (writing needs “write”) or the business is suspended (CLINIC_SUSPENDED).
404 NOT_FOUND
The record was not found or belongs to another business.
409 CONFLICT
The time is taken, the record’s status does not allow it, or the account is a demo (DEMO_MODE).
429 RATE_LIMITED
The per-minute limit (120) was exceeded.
Pagination
List endpoints use cursor pagination: the limit (1–100, default 50) and cursor parameters. Responses look like { items, nextCursor }; send nextCursor as cursor to get the next page. When nextCursor is null you are on the last page.
For real-time events, add an https URL under Settings › Integrations › Automation. Every delivery is a POST with a JSON body; Zapier, Make, n8n, Kommo and respond.io accept it directly.
Events
lead.created
A new person’s first contact: name, phone, channel, language and first message.
conversation.summary
When a conversation Zilko handled goes quiet for 30 minutes or the team takes over; last 10 messages.
appointment.created
Appointment created: person, start and end, status, source and staff member.
appointment.updated
Appointment changed (time, status or staff member).
appointment.cancelled
Appointment cancelled.
call.ended
Call ended: direction, duration, outcome and summary.
call.callback_requested
During a call the person asked to talk to the team now: reason, short note and number to call back.
Headers
X-Zilko-Event
event type, e.g. appointment.created
X-Zilko-Delivery
delivery ID (the same on retries)
X-Zilko-Signature
t=<unix seconds>,v1=<HMAC-SHA256 hex>
Verifying the signature: join the t from the header and the raw body as “t.body”, compute HMAC-SHA256 with the webhook’s signing key and compare it with v1 in constant time. Reject the request if t is older than 5 minutes. The id in the body is the event ID; use it to drop duplicates.
If the receiver answers with anything other than 2xx, or does not answer within 10 seconds, Zilko retries 5 times over about an hour. After 50 failed deliveries in a row the URL is turned off and the business is notified.
Account
The business the key belongs to.
GET/me
The key’s business
Responses
200Success
400Invalid request
401Missing, invalid or revoked key
403The key’s scope is not enough (writing needs "write")
{
"items": [
{
"id": "clx8f2k1a0001",
"direction": "IN",
"author": "PATIENT",
"text": "Hello, I would like information about implants.",
"createdAt": "2026-10-28T09:15:00.000Z"
}
],
"nextCursor": "clx8f2k1a0042"
}
Calls
Voice assistant calls with summary and transcript (read-only).
GET/calls
List calls
Parameters
fromstring (date-time)query
tostring (date-time)query
contactIdstringquery
cursorstringquery
The nextCursor from the previous response.
limitintegerquery
1–100 · default 50
Responses
200Success
400Invalid request
401Missing, invalid or revoked key
403The key’s scope is not enough (writing needs "write")