API and integrations
What the API can do
With the API your own system can read and write the same things you can see in TelefonAI: calls, bookings, customers, services and assistants.
That is useful if you want bookings in your own records system, or want to send call data on to your own reporting.
Getting started
- Create an API key under Settings → API and integrations (see the article about API keys).
- Send the key as
Authorization: Bearer <your-api-key>. - Call the endpoint you need.
The documentation with all endpoints is in the same place.
Two things that save you trouble
Use Idempotency-Key when you create something. If you send the same request twice — because the network failed midway — you get the same response back instead of a duplicate.
Be careful with POST and an id. If you include an id, the call updates the existing record instead of creating a new one.
Security
The key gives access to customer information. Keep it in your server's environment variables — never in code that is sent to a browser or an app. If it is compromised, rotate it immediately.