{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"622aa30c-6e66-4230-ba3e-907036f90cf3","name":"TeleCalendar API","description":"## **Introduction**\n\nThe TeleCalendar API allows you to interact with an organization in TeleCalendar. The API is RESTful and uses JSON to transport information.\n\nThe main use case for interacting with a TeleCalendar organization through the API is to manipulate appointments.\n\nThis documentation aims to provide comprehensive information on how developers can use the TeleCalendar API to start building integrations with TeleCalendar.\n\nPlease don't hesitate to reach out if you have any questions!\n\n[info@telecalendar.com](https://mailto:info@telecalendar.com)\n\n---\n\n# **API Basics**\n\nEach API resource that you use will have a clearly defined path structure. This documentation contains a reference for each resource in the API.\n\nBefore you can use these resources, below is the basic structure of an API resource:\n\n## **API Path**\n\nThe TeleCalendar API path has the following structure (depending on the endpoint):\n\n[<code>https://api.telecalendar.com/api</code>](https://api.telecalendar.com/api)  \nOR  \n[<code>https://app.telecalendar.com/api</code>](https://api.telecalendar.com/api)\n\n## **Requests**\n\nThere are different approaches for making requests to our API. The command line tool cURL is easy and fast for testing our API. When you want to integrate the API into your own software, you can choose to use a general purpose REST library based on your application language. The documentation of each resource shows specific ways in which you can make request for each resource.\n\nA REST API uses HTTP methods to determine which action to perform on the resource. GET, POST, PUT and DELETE are some of the common methods used in the TeleCalendar API resources. The type of method is also indicated in the resource documentation.\n\n---\n\n# **Authentication**\n\nIn order to access the TeleCalendar API, you have to be an authenticated user. TeleCalendar uses HTTP authentication via Bearer (token) authorization.\n\n## **Generating an API token**\n\nYour TeleCalendar admin can generate and provide you with the API token that you can use. Each API token is linked to a TeleCalendar organization user.\n\n## **Authorization**\n\nOnce you have an API token, it can be passed in the header of the request to authenticate your request:\n\n'Authorization: Bearer \\*_\\\\_'\n\nEvery endpoint in this collection requires the token, including Create appointment and Get available time slots.\n\n---\n\n# **Responses**\n\nEvery response uses the same envelope:\n\n```\n{\n  \"status\": \"success\",\n  \"data\": { },\n  \"pagination\": { }\n}\n\n ```\n\n`pagination` is present on list endpoints only. Errors use the same shape:\n\n```\n{\n  \"status\": \"error\",\n  \"timestamp\": \"2026-09-02T04:24:39.000Z\",\n  \"path\": \"/api/appointments\",\n  \"error\": {\n    \"code\": \"BadRequest\",\n    \"message\": \"Invalid request parameters\",\n    \"statusCode\": 400\n  }\n}\n\n ```\n\n**Status codes**\n\n| Code | Meaning |\n| --- | --- |\n| 400 | The request was not valid |\n| 401 | The api token is missing or unknown |\n| 404 | Not found, or not part of your organization |\n| 422 | The request could not be processed |\n| 424 | The account manager has no active calendar connection |\n| 429 | Rate limit exceeded |\n| 5xx | Unexpected error |\n\nAnything your token may not see returns 404 rather than 403, so a token cannot be used to discover another organization's appointments or people.\n\n---\n\n# **Changes**\n\n**Get appointments is now cursor paginated.** Pass `pagination.nextCursor` from a response as the `cursor` query parameter to fetch the next page. `take` still works as an alias for `limit`; `skip` is no longer supported and returns 400. `status` now takes one value per request rather than a comma separated list.\n\n**Appointments are addressed by** **`uid`****.** Responses no longer carry an internal numeric `id`.\n\n**Create appointment and Get available time slots now require the api token.**","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"39543393","team":6591863,"collectionId":"622aa30c-6e66-4230-ba3e-907036f90cf3","publishedId":"2sAYBbe9WS","public":true,"publicUrl":"https://developer.telecalendar.com","privateUrl":"https://go.postman.co/documentation/39543393-622aa30c-6e66-4230-ba3e-907036f90cf3","customColor":{"top-bar":"FFFFFF","right-sidebar":"000000","highlight":"F96C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"dark","themes":[{"name":"dark","logo":"https://content.pstmn.io/962f29e7-4ebf-429a-8914-6b326ce90382/VGVsZUNhbGVuZGFyIGxvZ28gYmxhY2sucG5n","colors":{"top-bar":"212121","right-sidebar":"000000","highlight":"e5f53e"}},{"name":"light","logo":"https://content.pstmn.io/0af6f949-c283-4bc4-ae76-5b16b7523fc7/VGVsZUNhbGVuZGFyIGxvZ290eXBlIHdoaXRlLWJsYWNrLnBuZw==","colors":{"top-bar":"FFFFFF","right-sidebar":"000000","highlight":"F96C37"}}]}},"version":"8.12.7","publishDate":"2026-09-07T07:21:40.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/0af6f949-c283-4bc4-ae76-5b16b7523fc7/VGVsZUNhbGVuZGFyIGxvZ290eXBlIHdoaXRlLWJsYWNrLnBuZw==","logoDark":"https://content.pstmn.io/962f29e7-4ebf-429a-8914-6b326ce90382/VGVsZUNhbGVuZGFyIGxvZ28gYmxhY2sucG5n"}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/3d1737116cab8fc72b9d0d4418dc48d39bd5e3899a66a1160fb9ab33832d91d3","favicon":"https://telecalendar.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://developer.telecalendar.com/view/metadata/2sAYBbe9WS"}