To get started instantly, click here, find a method and start using it. For more detailed information, please read this page first.
This document describes the various endpoints that Telavox exposes as the Open API. These endpoints are primarily intended for 3rd party systems that need to integrate with Telavox Flow. The reader of this documentation should be familiar with common concepts in Flow (the end-user application) and related technologies before attempting to implement a client that utilizes these services.
Changes and additions to our API will be announced on this page. Telavox reserves the right to block usage, in our sole discretion, to our API for anyone who misuses it.
Accessing our API
The Telavox Open API is located at
All API methods' paths are relative to this url.
Authentication and sessions
All Open API requests uses Bearer authentication with JSON Web Tokens. The tokens are unique to each user and managed in Flow - Settings - My Account - Username and password. A faulty token will be responded with a
401 Unauthorized resopnse.
One must keep in mind when designing and adapting systems integrating with Open API that any and all data and configuration may be changed from another source. Thus it’s recommended to not store a replica of the data fetched unless it’s very frequently read and it’s accuracy isn’t critical, and when updating information in Flow it’s recommended that the information is first refreshed to make sure no modification has been made from another source since the information was first retrieved.
Character encoding and request methods
The content type and encoding of each API method is specified in the
Content-Type response header. Most of the responses are
JSON formatted, and all are UTF-8 encoded.
The character encoding used in request URLs is not well
defined, meaning that non US-ASCII characters might present a problem
and not be portable. We highly recommend specifying an appropriate
Content-Type header in every request.
Please see the reference documentation for the details on the API endpoints.
For more information about JSON go to http://www.json.org. Implementations are freely available for most popular languages.
To explore our API in a browser, one can use the excellent Chrome add-on
Postman. It can monitor
XmlHttpRequests sent by the
browser and by analysing these one can get a better understanding of how
the API works.