The TeleCalendar API allows you to interact with an organization in TeleCalendar. The API is RESTful and uses JSON to transport information.
\nThe main use case for interacting with a TeleCalendar organization through the API is to manipulate appointments.
\nThis documentation aims to provide comprehensive information on how developers can use the TeleCalendar API to start building integrations with TeleCalendar.
\nPlease don't hesitate to reach out if you have any questions!
\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.
\nBefore you can use these resources, below is the basic structure of an API resource:
\nThe TeleCalendar API path has the following structure (depending on the endpoint):
\nhttps://api.telecalendar.com/api
ORhttps://app.telecalendar.com/api
There 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.
\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.
\nIn order to access the TeleCalendar API, you have to be an authenticated user. TeleCalendar uses HTTP authentication via Bearer (token) authorization.
\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.
\nOnce you have an API token, it can be passed in the header of the request to authenticate your request:
\n'Authorization: Bearer *\\'
\nEvery endpoint in this collection requires the token, including Create appointment and Get available time slots.
\nEvery response uses the same envelope:
\n{\n \"status\": \"success\",\n \"data\": { },\n \"pagination\": { }\n}\n\npagination is present on list endpoints only. Errors use the same shape:
{\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\nStatus codes
\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.
\nGet 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.
Appointments are addressed by uid****. Responses no longer carry an internal numeric id.
Create appointment and Get available time slots now require the api token.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"API Basics","slug":"api-basics"},{"content":"Authentication","slug":"authentication"},{"content":"Responses","slug":"responses"},{"content":"Changes","slug":"changes"}],"owner":"39543393","collectionId":"622aa30c-6e66-4230-ba3e-907036f90cf3","publishedId":"2sAYBbe9WS","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"000000","highlight":"F96C37"},"publishDate":"2026-09-07T07:21:40.000Z"},"item":[{"name":"Appointments","item":[{"name":"Create appointment","id":"b05f461d-836e-471b-962f-5ada0892d7eb","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"start\": \"2026-09-29T09:00:00.000+02:00\",\n \"eventTypeId\": 4169488,\n \"attendee\": {\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"timeZone\": \"Europe/Amsterdam\",\n \"language\": \"nl\"\n },\n \"location\": {\n \"type\": \"integration\",\n \"integration\": \"google-meet\"\n },\n \"guests\": [\n \"info@telecalendar.com\"\n ],\n \"bookingFieldsResponses\": {\n \"BEDRIJFSNAAM\": \"Business 123\"\n }\n}"},"url":"https://api.telecalendar.com/api/appointments","description":"Creates an appointment on one of your organization's event types.
\nThe event type must belong to your organization, otherwise the request returns 404.
\nAppointments are addressed by uid everywhere in this API.
Lists the appointments on your organization's event types, newest first.
\nPagination is cursor based. Pass the pagination.nextCursor of a response as cursor to fetch the next page, and omit cursor for the first page. pagination.hasMore tells you whether another page exists.
take is still accepted as an alias for limit. skip is no longer supported and returns 400.
OPTIONAL
\nType: enum<string>
Filter appointments by status. One status per request: to list across several statuses, issue one request per status.
\nAllowed values:\nupcoming,\nrecurring,\npast,\ncancelled,\nunconfirmed
\nExample:\n?status=upcoming
\n","type":"text/plain"},"key":"status","value":"upcoming"},{"description":{"content":"OPTIONAL
\nType: string
Filter appointments by attendee email address.
\nExample:\n?attendeeEmail=john@example.com
\n","type":"text/plain"},"key":"attendeeEmail","value":""},{"description":{"content":"OPTIONAL
\nType: string
Filter appointments by attendee name.
\nExample:\n?attendeeName=John Doe
\n","type":"text/plain"},"key":"attendeeName","value":""},{"description":{"content":"OPTIONAL
\nType: string
Filter appointments that start after this date/time.\nFormat: UTC ISO 8601 datetime.
\nPassing afterStart without beforeEnd closes the window at the current time.
\nExample:\n?afterStart=2026-09-01T00:00:00.000Z
\n","type":"text/plain"},"key":"afterStart","value":"2026-09-01T00:00:00.000Z"},{"description":{"content":"OPTIONAL
\nType: string
Filter appointments that end before this date/time.\nFormat: UTC ISO 8601 datetime.
\nExample:\n?beforeEnd=2026-09-30T23:59:59.999Z
\n","type":"text/plain"},"key":"beforeEnd","value":"2026-09-30T23:59:59.999Z"},{"description":{"content":"OPTIONAL
\nType: string
Filter appointments created after this date/time.\nFormat: UTC ISO 8601 datetime.
\nExample:\n?afterCreatedAt=2026-09-01T00:00:00.000Z
\n","type":"text/plain"},"key":"afterCreatedAt","value":""},{"description":{"content":"OPTIONAL
\nType: string
Filter appointments created before this date/time.\nFormat: UTC ISO 8601 datetime.
\nExample:\n?beforeCreatedAt=2026-09-30T23:59:59.999Z
\n","type":"text/plain"},"key":"beforeCreatedAt","value":""},{"description":{"content":"OPTIONAL
\nType: string
Filter appointments updated after this date/time.\nFormat: UTC ISO 8601 datetime.
\nExample:\n?afterUpdatedAt=2026-09-01T00:00:00.000Z
\n","type":"text/plain"},"key":"afterUpdatedAt","value":""},{"description":{"content":"OPTIONAL
\nType: string
Filter appointments updated before this date/time.\nFormat: UTC ISO 8601 datetime.
\nExample:\n?beforeUpdatedAt=2026-09-30T23:59:59.999Z
\n","type":"text/plain"},"key":"beforeUpdatedAt","value":""},{"description":{"content":"OPTIONAL
\nType: enum<string>
Sort results by start time.
\nAllowed values:\nasc,\ndesc
\nExample:\n?sortStart=asc
\n","type":"text/plain"},"key":"sortStart","value":"asc"},{"description":{"content":"OPTIONAL
\nType: enum<string>
Sort results by end time.
\nAllowed values:\nasc,\ndesc
\nExample:\n?sortEnd=asc
\n","type":"text/plain"},"key":"sortEnd","value":""},{"description":{"content":"OPTIONAL
\nType: enum<string>
Sort results by creation time.
\nAllowed values:\nasc,\ndesc
\nExample:\n?sortCreated=desc
\n","type":"text/plain"},"key":"sortCreated","value":""},{"description":{"content":"OPTIONAL
\nType: enum<string>
Sort results by last update time.
\nAllowed values:\nasc,\ndesc
\nExample:\n?sortUpdatedAt=desc
\n","type":"text/plain"},"key":"sortUpdatedAt","value":""},{"description":{"content":"OPTIONAL
\nType: number
Number of appointments to return.\nMinimum 1, maximum 100, default 50.
\ntake is accepted as an alias.
Example:\n?limit=50
\n","type":"text/plain"},"key":"limit","value":"50"},{"description":{"content":"OPTIONAL
\nType: string
Opaque cursor for cursor based pagination. Pass the pagination.nextCursor value from a previous response to fetch the next page. Omit to fetch the first page.
Example:\n?cursor=eyJ2IjoxLCJzb3J0VXVpZCI6...
\n","type":"text/plain"},"key":"cursor","value":""}],"variable":[]}},"response":[{"id":"feb1997e-02e1-44c6-9fe9-8b9069d2155f","name":"Get appointments","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/appointments?status=upcoming&attendeeEmail&attendeeName&afterStart=2026-09-01T00:00:00.000Z&beforeEnd=2026-09-30T23:59:59.999Z&afterCreatedAt&beforeCreatedAt&afterUpdatedAt&beforeUpdatedAt&sortStart=asc&sortEnd&sortCreated&sortUpdatedAt&limit=50&cursor","protocol":"https","host":["api","telecalendar","com"],"path":["api","appointments"],"query":[{"key":"status","value":"upcoming","description":"OPTIONAL\n\nType: `enumReturns a single appointment.
\n:uid is the appointment uid. An appointment outside your organization returns 404.
Moves an appointment to a new start time.
\nReschedulable statuses are accepted and pending. A pending appointment stays pending until the host confirms it. Cancelled, declined and live instant appointments return 400: create a new appointment instead.
:uid is the appointment uid. An appointment outside your organization returns 404.
Cancels the appointment and emails the attendee a link to pick a new time.
\n:uid is the appointment uid. An appointment outside your organization returns 404.
Cancels an appointment.
\nFor a recurring appointment, pass the uid of the individual occurrence with cancelSubsequentBookings to also cancel everything after it. For a seated appointment, pass seatUid to remove one attendance rather than the whole appointment.
:uid is the appointment uid. An appointment outside your organization returns 404.
Records who did not turn up.
\nPass host: true for an absent host, and attendees with absent: true or false per email address. Sending absent: false reverses an earlier no-show.
:uid is the appointment uid. An appointment outside your organization returns 404.
Hands the appointment to another available host, chosen automatically.
\nRound robin event types only.
\n:uid is the appointment uid. An appointment outside your organization returns 404.
Hands the appointment to a named account manager.
\nRound robin event types only.
\n:uid is the appointment uid. An appointment outside your organization returns 404.
:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","appointments",":uid","reassign",":accountManagerId"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"uid"},{"type":"any","key":"accountManagerId"}]}},"response":[{"id":"df522917-bf2c-45e4-aa6e-6d4243c14aaa","name":"Reassign an appointment to a specific host","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reason\": \"The original host has another call\"\n}"},"url":{"raw":"https://api.telecalendar.com/api/appointments/:uid/reassign/:accountManagerId","protocol":"https","host":["api","telecalendar","com"],"path":["api","appointments",":uid","reassign",":accountManagerId"],"variable":[{"key":"uid"},{"key":"accountManagerId"}]},"description":"Hands the appointment to a named account manager.\n\nRound robin event types only.\n\n`:uid` is the appointment uid. An appointment outside your organization returns 404.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"uid\": \"rTq4W3t5CDTvAAYficfyUq\",\n \"title\": \"Appointment example\",\n \"description\": \"\",\n \"status\": \"accepted\",\n \"start\": \"2026-09-29T07:00:00.000Z\",\n \"end\": \"2026-09-29T07:30:00.000Z\",\n \"duration\": 30,\n \"eventTypeId\": 3019502,\n \"location\": \"https://meet.google.com/abc-defg-hij\",\n \"meetingUrl\": \"https://meet.google.com/abc-defg-hij\",\n \"absentHost\": false,\n \"createdAt\": \"2026-09-01T09:12:44.000Z\",\n \"updatedAt\": \"2026-09-01T09:12:44.000Z\",\n \"metadata\": {},\n \"hosts\": [\n {\n \"name\": \"Second Accountmanager\",\n \"email\": \"second@telecalendar.com\",\n \"timeZone\": \"Europe/Amsterdam\",\n \"accountManagerId\": \"w3x5y7z9a1b3c5d7\"\n }\n ],\n \"attendees\": [\n {\n \"id\": 22721465,\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"timeZone\": \"Europe/Amsterdam\",\n \"language\": \"nl\",\n \"absent\": false\n }\n ],\n \"guests\": [],\n \"bookingFieldsResponses\": {\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"BEDRIJFSNAAM\": \"Business 123\"\n }\n }\n}"}],"_postman_id":"428f4deb-03cd-4af8-8b16-c0a721b05749"},{"name":"Confirm an appointment","id":"c01bb6ef-d252-47af-9890-e499f7672704","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}"},"url":"https://api.telecalendar.com/api/appointments/:uid/confirm","description":"Confirms an appointment that is awaiting host confirmation.
\n:uid is the appointment uid. An appointment outside your organization returns 404.
Declines an appointment that is awaiting host confirmation.
\n:uid is the appointment uid. An appointment outside your organization returns 404.
Changes where an existing appointment takes place.
\nlocation must be one of the locations configured on the event type, passed as an object rather than a string.
:uid is the appointment uid. An appointment outside your organization returns 404.
Lists the attendees on an appointment.
\n:uid is the appointment uid. An appointment outside your organization returns 404.
Adds an attendee to an existing appointment.
\nname is required. Provide email, phoneNumber or both.
:uid is the appointment uid. An appointment outside your organization returns 404.
Returns one attendee.
\n:attendeeId is the id returned by Get all attendees.
:uid is the appointment uid. An appointment outside your organization returns 404.
Returns the free slots on one of your organization's event types, grouped by date.
\nThe event type must belong to your organization, otherwise the request returns 404.
\n","urlObject":{"protocol":"https","path":["api","time-slots"],"host":["api","telecalendar","com"],"query":[{"description":{"content":"REQUIRED
\nType: string
The event type to check availability for.
\nExample:\n?eventTypeId=4169488
\n","type":"text/plain"},"key":"eventTypeId","value":"4169488"},{"description":{"content":"REQUIRED
\nType: string
Start of the range to search.\nFormat: YYYY-MM-DD or UTC ISO 8601 datetime.
Example:\n?start=2026-09-29
\n","type":"text/plain"},"key":"start","value":"2026-09-29"},{"description":{"content":"REQUIRED
\nType: string
End of the range to search.\nFormat: YYYY-MM-DD or UTC ISO 8601 datetime.
Example:\n?end=2026-09-30
\n","type":"text/plain"},"key":"end","value":"2026-09-30"},{"description":{"content":"OPTIONAL
\nType: string
Slot length in minutes. Only needed for event types with a variable length.
\nExample:\n?duration=30
\n","type":"text/plain"},"key":"duration","value":"30"},{"description":{"content":"OPTIONAL
\nType: string
Time zone the returned slots are expressed in.\nDefaults to UTC.
\nExample:\n?timeZone=Europe/Amsterdam
\n","type":"text/plain"},"key":"timeZone","value":"Europe/Amsterdam"}],"variable":[]}},"response":[{"id":"80c0e164-db75-41f9-86d9-ed9628b0ecd7","name":"Get available time slots","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/time-slots?eventTypeId=4169488&start=2026-09-29&end=2026-09-30&duration=30&timeZone=Europe/Amsterdam","protocol":"https","host":["api","telecalendar","com"],"path":["api","time-slots"],"query":[{"key":"eventTypeId","value":"4169488","description":"REQUIRED\n\nType: `string`\n\nThe event type to check availability for.\n\nExample:\n?eventTypeId=4169488"},{"key":"start","value":"2026-09-29","description":"REQUIRED\n\nType: `string`\n\nStart of the range to search.\nFormat: `YYYY-MM-DD` or UTC ISO 8601 datetime.\n\nExample:\n?start=2026-09-29"},{"key":"end","value":"2026-09-30","description":"REQUIRED\n\nType: `string`\n\nEnd of the range to search.\nFormat: `YYYY-MM-DD` or UTC ISO 8601 datetime.\n\nExample:\n?end=2026-09-30"},{"key":"duration","value":"30","description":"OPTIONAL\n\nType: `string`\n\nSlot length in minutes. Only needed for event types with a variable length.\n\nExample:\n?duration=30"},{"key":"timeZone","value":"Europe/Amsterdam","description":"OPTIONAL\n\nType: `string`\n\nTime zone the returned slots are expressed in.\nDefaults to UTC.\n\nExample:\n?timeZone=Europe/Amsterdam"}]},"description":"Returns the free slots on one of your organization's event types, grouped by date.\n\nThe event type must belong to your organization, otherwise the request returns 404."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"2026-09-29\": [\n {\n \"start\": \"2026-09-29T09:00:00.000+02:00\"\n },\n {\n \"start\": \"2026-09-29T09:30:00.000+02:00\"\n },\n {\n \"start\": \"2026-09-29T10:00:00.000+02:00\"\n }\n ]\n }\n}"}],"_postman_id":"83f3b6a8-b1eb-46b0-b71a-d49adaf4d106"},{"name":"Get team recommendations","id":"f12d90ff-cd2b-4bc3-8c79-593b2dc1b688","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"eventTypeId\": \"4977046\",\n \"date\": \"2026-03-11\",\n \"address\": \"Palamedeestraat 38, 2026VX Haarlem\",\n \"maxCommuteMinutes\": 60\n}"},"url":"https://app.telecalendar.com/api/route-planning/team-recommendations","description":"eventTypeId — 4977046
Type: string
The ID of the TeleCalendar campaign event type to find team slots for.
REQUIRED
date — 2026-03-11
Type: string
Format: YYYY-MM-DD or DD-MM-YYYY
Any date within the target week. The endpoint searches the full Mon–Sun window.
REQUIRED
address — Palamedeestraat 38, 2026VX Haarlem
Type: string
The destination address. Used to calculate travel feasibility per account manager.
REQUIRED
maxCommuteMinutes — 60
Type: number
Override the campaign's default max commute time in minutes (max travel time between appointments).
OPTIONAL
RESPONSE
\ndate — 2026-03-11
Type: string
The normalised date from the request, returned as YYYY-MM-DD.
slots — []
Type:Â array
Up to 5 ranked available slots across the full Mon–Sun week, sorted by soonest start time.
slots[].eventTypeId — 4986435
Type:Â number
The child (host-specific) account manager event type ID used for this slot.
slots[].hostUserId — 1439196
Type:Â number
The user ID of the account manager assigned to this slot.
slots[].hostName — Rob Koopman
Type:Â string
Display name of the account manager.
slots[].start — 2026-03-10T13:00:00.000Z
Type:Â string
Format: UTC ISO8601. Start time of the available slot.
slots[].end — 2026-03-10T14:00:00.000Z
Type:Â string
Format: UTC ISO8601. End time of the available slot.
slots[].date — 2026-03-10
Type:Â string
The calendar date of this slot in YYYY-MM-DD. May differ from the request date as the endpoint searches the full week.
slots[].baselineTravelSeconds — 18
Type:Â number
Travel time in seconds between the preceding and following event without the new appointment (A→C direct). Used to compute the detour cost.
slots[].detourSeconds — 2850
Type:Â number
Extra travel added by inserting this slot: (A→B + B→C) - (A→C). Lower is better.
slots[].waitAtBSeconds — 18369
Type:Â number
Idle time the host would spend waiting at the destination before the slot starts.
slots[].checks — []
Type:Â array
Travel feasibility checks for the legs around this slot (before and after).
slots[].checks[].leg — before
Type:Â string
Enum: before, after. Which leg this check covers: travel to the slot (before) or away from it (after).
slots[].checks[].travelSeconds — 1431
Type:Â number
Estimated travel time in seconds for this leg.
slots[].checks[].availableSeconds — 19800
Type:Â number
Time buffer available for travel on this leg.
slots[].checks[].feasible — true
Type:Â boolean
Whether travel is feasible within the available window.
slots[].checks[].exceededMaxCommute — false
Type:Â boolean
Whether this leg exceeds the campaign's maxCommuteMinutes cap.
slots[].checks[].hidden — true
Type:Â boolean
If true, this check is a homebase anchor within 30 min and is suppressed in the UI.
OPTIONAL
slots[].checks[].conflictEvent.id — homebase-start-2026-03-10T07:30:00.000Z
Type:Â string
Unique event ID. IDs prefixed with homebase- are synthetic anchors from the host's home base.
slots[].checks[].conflictEvent.start — 2026-03-10T07:30:00.000Z
Type:Â string
Format: UTC ISO8601. Start time of the anchor event.
slots[].checks[].conflictEvent.end — 2026-03-10T07:30:00.000Z
Type:Â string
Format: UTC ISO8601. End time of the anchor event.
slots[].checks[].conflictEvent.location — Eosstraat, 1076DT, Amsterdam
Type:Â string
Address or location string of the anchor event.
slots[].checks[].conflictEvent.title — Rob Koopman - Rob Koopman
Type:Â string
Title of the anchor event. Not present on homebase anchors.
OPTIONAL
slots[].checks[].conflictEvent.duration — 45
Type:Â number
Duration of the anchor event in minutes. Not present on homebase anchors.
OPTIONAL
slots[].badges.shortestTravel — false
Type:Â boolean
True for the slot(s) with the lowest detourSeconds among the 5 returned.
slots[].badges.soonest — true
Type:Â boolean
True for the slot with the earliest start time among the 5 returned.
Holds a slot so it cannot be booked by someone else while your user completes a form.
\nThe reservation expires by itself. Delete it if the user abandons the flow.
\nThe event type must belong to your organization, otherwise the request returns 404.
\n","urlObject":{"protocol":"https","path":["api","time-slots","reservations"],"host":["api","telecalendar","com"],"query":[],"variable":[]}},"response":[{"id":"ab1e97b1-62ee-404f-8702-8d0b51b95e5c","name":"Reserve a slot","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"eventTypeId\": 4169488,\n \"slotStart\": \"2026-09-29T09:00:00.000Z\",\n \"slotDuration\": 30,\n \"reservationDuration\": 5\n}"},"url":"https://api.telecalendar.com/api/time-slots/reservations","description":"Holds a slot so it cannot be booked by someone else while your user completes a form.\n\nThe reservation expires by itself. Delete it if the user abandons the flow.\n\nThe event type must belong to your organization, otherwise the request returns 404."},"status":"OK","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"eventTypeId\": 4169488,\n \"slotStart\": \"2026-09-29T09:00:00.000Z\",\n \"slotEnd\": \"2026-09-29T09:30:00.000Z\",\n \"slotDuration\": 30,\n \"reservationUid\": \"e2b7f4c1-3a55-4d21-9f0e-77c1a2b3d4e5\",\n \"reservationDuration\": 5,\n \"reservationUntil\": \"2026-09-01T09:17:44.000Z\"\n }\n}"}],"_postman_id":"8040f40b-6ae0-41c9-8611-65b64defff56"},{"name":"Get reserved slot","id":"ee1c0d18-ea19-4811-999c-51c7bcc9c04b","request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/time-slots/reservations/:uid","description":"Returns a slot reservation.
\n:uid is the reservationUid returned by Reserve a slot. A reservation on another organization's event type returns 404.
Moves a reservation to a different slot or extends how long it is held.
\n:uid is the reservationUid returned by Reserve a slot.
Releases a slot reservation so the slot is bookable again.
\n:uid is the reservationUid returned by Reserve a slot.
Lists your organization's account managers.
\nThe id returned here is the :accountManagerId used by the schedules, calendars and conferencing endpoints.
Returns one account manager.
\n:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"}]}},"response":[{"id":"2cf916c6-f1c9-4408-b00c-98172636a790","name":"Get an account manager","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId"],"variable":[{"key":"accountManagerId"}]},"description":"Returns one account manager.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"id\": \"k1m9p2q7r4s6t8v0\",\n \"name\": \"Accountmanager Test\",\n \"email\": \"info@telecalendar.com\",\n \"language\": \"nl\",\n \"isActive\": true\n }\n}"}],"_postman_id":"953eb41e-dbbf-4a25-aa8a-3178bb63c80c"}],"id":"07c8489f-20ed-444f-b8ba-1acddcda5405","_postman_id":"07c8489f-20ed-444f-b8ba-1acddcda5405","description":""},{"name":"Schedules","item":[{"name":"Create a schedule","id":"28decf4a-8432-458b-98ab-30930f3ef951","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Working hours\",\n \"timeZone\": \"Europe/Amsterdam\",\n \"availability\": [\n {\n \"days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\"\n ],\n \"startTime\": \"09:00\",\n \"endTime\": \"17:00\"\n }\n ],\n \"isDefault\": true\n}"},"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules","description":"Creates an availability schedule for an account manager.
\nname and timeZone are required.
:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","schedules"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"}]}},"response":[{"id":"3eaed6b8-3d5b-48ae-8bd3-5fb867f6a990","name":"Create a schedule","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Working hours\",\n \"timeZone\": \"Europe/Amsterdam\",\n \"availability\": [\n {\n \"days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\"\n ],\n \"startTime\": \"09:00\",\n \"endTime\": \"17:00\"\n }\n ],\n \"isDefault\": true\n}"},"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","schedules"],"variable":[{"key":"accountManagerId"}]},"description":"Creates an availability schedule for an account manager.\n\n`name` and `timeZone` are required.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"id\": 254213,\n \"name\": \"Working hours\",\n \"timeZone\": \"Europe/Amsterdam\",\n \"availability\": [\n {\n \"days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\"\n ],\n \"startTime\": \"09:00\",\n \"endTime\": \"17:00\"\n }\n ],\n \"isDefault\": true,\n \"overrides\": [\n {\n \"date\": \"2026-12-25\",\n \"startTime\": \"09:00\",\n \"endTime\": \"12:00\"\n }\n ]\n }\n}"}],"_postman_id":"28decf4a-8432-458b-98ab-30930f3ef951"},{"name":"Get all schedules","id":"45c4963f-6240-402e-a728-80311c6b0a12","request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules","description":"Lists an account manager's availability schedules.
\n:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","schedules"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"}]}},"response":[{"id":"dffe3abb-218d-4b32-a12a-64ce3f53b6df","name":"Get all schedules","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","schedules"],"variable":[{"key":"accountManagerId"}]},"description":"Lists an account manager's availability schedules.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": [\n {\n \"id\": 254213,\n \"name\": \"Working hours\",\n \"timeZone\": \"Europe/Amsterdam\",\n \"availability\": [\n {\n \"days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\"\n ],\n \"startTime\": \"09:00\",\n \"endTime\": \"17:00\"\n }\n ],\n \"isDefault\": true,\n \"overrides\": [\n {\n \"date\": \"2026-12-25\",\n \"startTime\": \"09:00\",\n \"endTime\": \"12:00\"\n }\n ]\n }\n ]\n}"}],"_postman_id":"45c4963f-6240-402e-a728-80311c6b0a12"},{"name":"Get default schedule","id":"b6867130-82c4-4ab0-bc25-81f82fb46b3b","request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules/default","description":"Returns the schedule an account manager's event types fall back to.
\n:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","schedules","default"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"}]}},"response":[{"id":"9a0bac8c-2dfd-4039-929c-23f6ed9fcce7","name":"Get default schedule","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules/default","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","schedules","default"],"variable":[{"key":"accountManagerId"}]},"description":"Returns the schedule an account manager's event types fall back to.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"id\": 254213,\n \"name\": \"Working hours\",\n \"timeZone\": \"Europe/Amsterdam\",\n \"availability\": [\n {\n \"days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\"\n ],\n \"startTime\": \"09:00\",\n \"endTime\": \"17:00\"\n }\n ],\n \"isDefault\": true,\n \"overrides\": [\n {\n \"date\": \"2026-12-25\",\n \"startTime\": \"09:00\",\n \"endTime\": \"12:00\"\n }\n ]\n }\n}"}],"_postman_id":"b6867130-82c4-4ab0-bc25-81f82fb46b3b"},{"name":"Get a schedule","id":"1c92bbe2-d645-4a06-a7eb-3d8976f7ad42","request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules/:scheduleId","description":"Returns one availability schedule.
\n:scheduleId is the id returned by Get all schedules.
:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","schedules",":scheduleId"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"},{"type":"any","key":"scheduleId"}]}},"response":[{"id":"f02bfa37-2261-43ab-a3eb-cc3c419d05af","name":"Get a schedule","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules/:scheduleId","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","schedules",":scheduleId"],"variable":[{"key":"accountManagerId"},{"key":"scheduleId"}]},"description":"Returns one availability schedule.\n\n`:scheduleId` is the `id` returned by Get all schedules.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"id\": 254213,\n \"name\": \"Working hours\",\n \"timeZone\": \"Europe/Amsterdam\",\n \"availability\": [\n {\n \"days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\"\n ],\n \"startTime\": \"09:00\",\n \"endTime\": \"17:00\"\n }\n ],\n \"isDefault\": true,\n \"overrides\": [\n {\n \"date\": \"2026-12-25\",\n \"startTime\": \"09:00\",\n \"endTime\": \"12:00\"\n }\n ]\n }\n}"}],"_postman_id":"1c92bbe2-d645-4a06-a7eb-3d8976f7ad42"},{"name":"Update a schedule","id":"4dcaed88-57ae-4aeb-b0fb-50ceaa39b03d","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"PATCH","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Working hours (summer)\",\n \"availability\": [\n {\n \"days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\"\n ],\n \"startTime\": \"08:00\",\n \"endTime\": \"16:00\"\n }\n ]\n}"},"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules/:scheduleId","description":"Partially updates an availability schedule. Only the fields you send are changed.
\n:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","schedules",":scheduleId"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"},{"type":"any","key":"scheduleId"}]}},"response":[{"id":"085f65aa-4600-4ae2-83aa-9d32b778cc99","name":"Update a schedule","originalRequest":{"method":"PATCH","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Working hours (summer)\",\n \"availability\": [\n {\n \"days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\"\n ],\n \"startTime\": \"08:00\",\n \"endTime\": \"16:00\"\n }\n ]\n}"},"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules/:scheduleId","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","schedules",":scheduleId"],"variable":[{"key":"accountManagerId"},{"key":"scheduleId"}]},"description":"Partially updates an availability schedule. Only the fields you send are changed.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"id\": 254213,\n \"name\": \"Working hours\",\n \"timeZone\": \"Europe/Amsterdam\",\n \"availability\": [\n {\n \"days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\"\n ],\n \"startTime\": \"09:00\",\n \"endTime\": \"17:00\"\n }\n ],\n \"isDefault\": true,\n \"overrides\": [\n {\n \"date\": \"2026-12-25\",\n \"startTime\": \"09:00\",\n \"endTime\": \"12:00\"\n }\n ]\n }\n}"}],"_postman_id":"4dcaed88-57ae-4aeb-b0fb-50ceaa39b03d"},{"name":"Delete a schedule","id":"2fa6a77c-c7f7-4454-9fee-b2edb9401c3c","request":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules/:scheduleId","description":"Deletes an availability schedule.
\n:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","schedules",":scheduleId"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"},{"type":"any","key":"scheduleId"}]}},"response":[{"id":"51962ea0-9616-44c9-8c61-343897f0fb9b","name":"Delete a schedule","originalRequest":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/schedules/:scheduleId","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","schedules",":scheduleId"],"variable":[{"key":"accountManagerId"},{"key":"scheduleId"}]},"description":"Deletes an availability schedule.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": null\n}"}],"_postman_id":"2fa6a77c-c7f7-4454-9fee-b2edb9401c3c"}],"id":"9cddee08-901b-4acf-bff1-6adcaa6bf79e","_postman_id":"9cddee08-901b-4acf-bff1-6adcaa6bf79e","description":""},{"name":"Calendars","item":[{"name":"Check a calendar connection","id":"ffd3a6e7-c2fb-4bbe-8490-91786afdd769","request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/calendars/:calendar/check","description":"Reports whether an account manager's calendar is connected and healthy.
\n:calendar is one of apple, google, office365.
:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","calendars",":calendar","check"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"},{"type":"any","key":"calendar"}]}},"response":[{"id":"83baeee7-0865-4fb5-aa4e-3e0b941c9b9b","name":"Check a calendar connection","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/calendars/:calendar/check","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","calendars",":calendar","check"],"variable":[{"key":"accountManagerId"},{"key":"calendar"}]},"description":"Reports whether an account manager's calendar is connected and healthy.\n\n`:calendar` is one of `apple`, `google`, `office365`.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"calendar\": \"google\",\n \"connected\": true\n }\n}"}],"_postman_id":"ffd3a6e7-c2fb-4bbe-8490-91786afdd769"},{"name":"Disconnect a calendar","id":"49aa82d7-d989-4dbe-94e3-dd5a656b8d17","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}"},"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/calendars/:calendar/disconnect","description":"Disconnects an account manager's calendar.
\n:calendar is one of apple, google, office365.
The account manager stops receiving conflict checks against that calendar until it is reconnected.
\n:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","calendars",":calendar","disconnect"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"},{"type":"any","key":"calendar"}]}},"response":[{"id":"e1798222-ca4f-42d1-a192-88afa95ba513","name":"Disconnect a calendar","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}"},"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/calendars/:calendar/disconnect","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","calendars",":calendar","disconnect"],"variable":[{"key":"accountManagerId"},{"key":"calendar"}]},"description":"Disconnects an account manager's calendar.\n\n`:calendar` is one of `apple`, `google`, `office365`.\n\nThe account manager stops receiving conflict checks against that calendar until it is reconnected.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"calendar\": \"google\",\n \"connected\": false\n }\n}"}],"_postman_id":"49aa82d7-d989-4dbe-94e3-dd5a656b8d17"},{"name":"Add a selected calendar","id":"38212049-4cda-43a0-8482-a7948516003e","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"integration\": \"google_calendar\",\n \"externalId\": \"info@telecalendar.com\",\n \"credentialId\": 90210\n}"},"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/selected-calendars","description":"Adds a calendar to the set checked for conflicts when looking for free slots.
\nintegration, externalId and credentialId are required.
:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","selected-calendars"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"}]}},"response":[{"id":"a7f37615-c499-4d20-8ad4-98d653674c76","name":"Add a selected calendar","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"integration\": \"google_calendar\",\n \"externalId\": \"info@telecalendar.com\",\n \"credentialId\": 90210\n}"},"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/selected-calendars","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","selected-calendars"],"variable":[{"key":"accountManagerId"}]},"description":"Adds a calendar to the set checked for conflicts when looking for free slots.\n\n`integration`, `externalId` and `credentialId` are required.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"integration\": \"google_calendar\",\n \"externalId\": \"info@telecalendar.com\",\n \"credentialId\": 90210\n }\n}"}],"_postman_id":"38212049-4cda-43a0-8482-a7948516003e"},{"name":"Delete a selected calendar","id":"7658ca79-de6d-4701-93f3-79ed3e3eedd3","request":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/selected-calendars?integration=google_calendar&externalId=info@telecalendar.com&credentialId=90210&delegationCredentialId=","description":"Stops checking a calendar for conflicts.
\nThe identifying fields are passed as query parameters, not as a body.
\n:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","selected-calendars"],"host":["api","telecalendar","com"],"query":[{"description":{"content":"REQUIRED
\nType: string
The calendar service the calendar belongs to.
\nExample:\n?integration=google_calendar
\n","type":"text/plain"},"key":"integration","value":"google_calendar"},{"description":{"content":"REQUIRED
\nType: string
Identifier of the calendar within that service.
\nExample:\n?externalId=info@telecalendar.com
\n","type":"text/plain"},"key":"externalId","value":"info@telecalendar.com"},{"description":{"content":"REQUIRED
\nType: number
Identifier of the connection the calendar was added through.
\nExample:\n?credentialId=90210
\n","type":"text/plain"},"key":"credentialId","value":"90210"},{"description":{"content":"OPTIONAL
\nType: string
Only for calendars connected through domain wide delegation.
\n","type":"text/plain"},"key":"delegationCredentialId","value":""}],"variable":[{"type":"any","key":"accountManagerId"}]}},"response":[{"id":"0b850d30-e51c-49b7-853e-8e249f940688","name":"Delete a selected calendar","originalRequest":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/selected-calendars?integration=google_calendar&externalId=info@telecalendar.com&credentialId=90210&delegationCredentialId","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","selected-calendars"],"query":[{"key":"integration","value":"google_calendar","description":"REQUIRED\n\nType: `string`\n\nThe calendar service the calendar belongs to.\n\nExample:\n?integration=google_calendar"},{"key":"externalId","value":"info@telecalendar.com","description":"REQUIRED\n\nType: `string`\n\nIdentifier of the calendar within that service.\n\nExample:\n?externalId=info@telecalendar.com"},{"key":"credentialId","value":"90210","description":"REQUIRED\n\nType: `number`\n\nIdentifier of the connection the calendar was added through.\n\nExample:\n?credentialId=90210"},{"key":"delegationCredentialId","value":null,"description":"OPTIONAL\n\nType: `string`\n\nOnly for calendars connected through domain wide delegation."}],"variable":[{"key":"accountManagerId"}]},"description":"Stops checking a calendar for conflicts.\n\nThe identifying fields are passed as query parameters, not as a body.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"integration\": \"google_calendar\",\n \"externalId\": \"info@telecalendar.com\",\n \"credentialId\": 90210\n }\n}"}],"_postman_id":"7658ca79-de6d-4701-93f3-79ed3e3eedd3"},{"name":"Update destination calendars","id":"3bda5f92-9340-4e31-aedc-c40f457b76bc","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"PUT","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"integration\": \"google_calendar\",\n \"externalId\": \"info@telecalendar.com\"\n}"},"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/destination-calendars","description":"Sets the calendar new appointments are written to.
\nintegration is one of apple_calendar, google_calendar, office365_calendar. externalId identifies the calendar within that service.
:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","destination-calendars"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"}]}},"response":[{"id":"8280d23e-9679-4904-99f9-3a374c1a038b","name":"Update destination calendars","originalRequest":{"method":"PUT","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"integration\": \"google_calendar\",\n \"externalId\": \"info@telecalendar.com\"\n}"},"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/destination-calendars","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","destination-calendars"],"variable":[{"key":"accountManagerId"}]},"description":"Sets the calendar new appointments are written to.\n\n`integration` is one of `apple_calendar`, `google_calendar`, `office365_calendar`. `externalId` identifies the calendar within that service.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"integration\": \"google_calendar\",\n \"externalId\": \"info@telecalendar.com\",\n \"credentialId\": 90210,\n \"primaryEmail\": \"info@telecalendar.com\"\n }\n}"}],"_postman_id":"3bda5f92-9340-4e31-aedc-c40f457b76bc"}],"id":"d8d169cb-4979-4645-a39e-f775f8c29202","_postman_id":"d8d169cb-4979-4645-a39e-f775f8c29202","description":""},{"name":"Conferencing apps","item":[{"name":"List your conferencing applications","id":"5dd5ffd8-6afb-48f0-b2ee-091a052b7107","request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing","description":"Lists the conferencing applications connected for an account manager.
\ninvalid is true when the connection needs to be re-authorised.
:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","conferencing"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"}]}},"response":[{"id":"63f0c736-17b2-46bd-bb2f-affed3351f38","name":"List your conferencing applications","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","conferencing"],"variable":[{"key":"accountManagerId"}]},"description":"Lists the conferencing applications connected for an account manager.\n\n`invalid` is true when the connection needs to be re-authorised.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": [\n {\n \"type\": \"google_video\",\n \"invalid\": false\n },\n {\n \"type\": \"zoom_video\",\n \"invalid\": false\n }\n ]\n}"}],"_postman_id":"5dd5ffd8-6afb-48f0-b2ee-091a052b7107"},{"name":"Get your default conferencing application","id":"b0bc8b05-0c03-49df-978b-feb757ba75c4","request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing/default","description":"Returns the conferencing application new appointments use by default.
\n:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","conferencing","default"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"}]}},"response":[{"id":"8147efa4-ef10-421a-a63e-bed825eb021b","name":"Get your default conferencing application","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing/default","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","conferencing","default"],"variable":[{"key":"accountManagerId"}]},"description":"Returns the conferencing application new appointments use by default.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"type\": \"google_video\",\n \"invalid\": false\n }\n}"}],"_postman_id":"b0bc8b05-0c03-49df-978b-feb757ba75c4"},{"name":"Connect your conferencing application","id":"110a9e5d-65cc-484c-9da2-b9fe10560049","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}"},"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing/:app/connect","description":"Connects a conferencing application that needs no consent screen.
\n:app is google-meet. Zoom and Microsoft Teams go through Get OAuth conferencing app auth URL instead.
Google Meet requires the account manager's Google calendar to be connected first.
\n:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","conferencing",":app","connect"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"},{"type":"any","key":"app"}]}},"response":[{"id":"165a6f28-2c83-4857-ba75-e8a5142bc90d","name":"Connect your conferencing application","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}"},"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing/:app/connect","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","conferencing",":app","connect"],"variable":[{"key":"accountManagerId"},{"key":"app"}]},"description":"Connects a conferencing application that needs no consent screen.\n\n`:app` is `google-meet`. Zoom and Microsoft Teams go through Get OAuth conferencing app auth URL instead.\n\nGoogle Meet requires the account manager's Google calendar to be connected first.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"type\": \"google_video\",\n \"invalid\": false\n }\n}"}],"_postman_id":"110a9e5d-65cc-484c-9da2-b9fe10560049"},{"name":"Get OAuth conferencing app auth URL","id":"e5bbed6a-be4a-4f95-8d51-03597a6dcc09","request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing/:app/oauth/auth-url?returnTo=https://app.telecalendar.com/onboarding&onErrorReturnTo=","description":"Returns the url to send the account manager to so they can authorise a conferencing application.
\n:app is zoom or msteams.
:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","conferencing",":app","oauth","auth-url"],"host":["api","telecalendar","com"],"query":[{"description":{"content":"REQUIRED
\nType: string
Where to send the account manager after they authorise.
\nExample:\n?returnTo=https://app.telecalendar.com/onboarding
\n","type":"text/plain"},"key":"returnTo","value":"https://app.telecalendar.com/onboarding"},{"description":{"content":"OPTIONAL
\nType: string
Where to send the account manager if authorisation fails.
\nExample:\n?onErrorReturnTo=https://app.telecalendar.com/onboarding?error=1
\n","type":"text/plain"},"key":"onErrorReturnTo","value":""}],"variable":[{"type":"any","key":"accountManagerId"},{"type":"any","key":"app"}]}},"response":[{"id":"25d58a88-a271-4fba-9a86-5d7f8c1c7e1e","name":"Get OAuth conferencing app auth URL","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing/:app/oauth/auth-url?returnTo=https://app.telecalendar.com/onboarding&onErrorReturnTo","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","conferencing",":app","oauth","auth-url"],"query":[{"key":"returnTo","value":"https://app.telecalendar.com/onboarding","description":"REQUIRED\n\nType: `string`\n\nWhere to send the account manager after they authorise.\n\nExample:\n?returnTo=https://app.telecalendar.com/onboarding"},{"key":"onErrorReturnTo","value":null,"description":"OPTIONAL\n\nType: `string`\n\nWhere to send the account manager if authorisation fails.\n\nExample:\n?onErrorReturnTo=https://app.telecalendar.com/onboarding?error=1"}],"variable":[{"key":"accountManagerId"},{"key":"app"}]},"description":"Returns the url to send the account manager to so they can authorise a conferencing application.\n\n`:app` is `zoom` or `msteams`.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"app\": \"zoom\",\n \"authUrl\": \"https://zoom.us/oauth/authorize?...\"\n }\n}"}],"_postman_id":"e5bbed6a-be4a-4f95-8d51-03597a6dcc09"},{"name":"Set your default conferencing application","id":"7d1b1232-f471-4958-981e-c3ab04905210","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}"},"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing/:app/default","description":"Makes a connected conferencing application the default for new appointments.
\n:app is one of google-meet, zoom, msteams, daily-video.
:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","conferencing",":app","default"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"},{"type":"any","key":"app"}]}},"response":[{"id":"bbefa612-0ca1-46c5-a241-70a3c88f0c1b","name":"Set your default conferencing application","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}"},"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing/:app/default","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","conferencing",":app","default"],"variable":[{"key":"accountManagerId"},{"key":"app"}]},"description":"Makes a connected conferencing application the default for new appointments.\n\n`:app` is one of `google-meet`, `zoom`, `msteams`, `daily-video`.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"app\": \"google-meet\"\n }\n}"}],"_postman_id":"7d1b1232-f471-4958-981e-c3ab04905210"},{"name":"Disconnect your conferencing application","id":"0cf2d839-c210-4da8-a707-14b4756c2015","request":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing/:app/disconnect","description":"Disconnects a conferencing application.
\n:app is one of google-meet, zoom, msteams.
:accountManagerId is the account manager id returned by GET /api/account-managers. An account manager belonging to another organization returns 404.
Returns 424 when the account manager has no active calendar connection.
\n","urlObject":{"protocol":"https","path":["api","account-managers",":accountManagerId","conferencing",":app","disconnect"],"host":["api","telecalendar","com"],"query":[],"variable":[{"type":"any","key":"accountManagerId"},{"type":"any","key":"app"}]}},"response":[{"id":"70efe4ac-aec2-4b6f-97aa-41b2c15d8735","name":"Disconnect your conferencing application","originalRequest":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer {api_token}","type":"text"}],"url":{"raw":"https://api.telecalendar.com/api/account-managers/:accountManagerId/conferencing/:app/disconnect","protocol":"https","host":["api","telecalendar","com"],"path":["api","account-managers",":accountManagerId","conferencing",":app","disconnect"],"variable":[{"key":"accountManagerId"},{"key":"app"}]},"description":"Disconnects a conferencing application.\n\n`:app` is one of `google-meet`, `zoom`, `msteams`.\n\n`:accountManagerId` is the account manager id returned by `GET /api/account-managers`. An account manager belonging to another organization returns 404.\n\nReturns 424 when the account manager has no active calendar connection."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"app\": \"google-meet\",\n \"connected\": false\n }\n}"}],"_postman_id":"0cf2d839-c210-4da8-a707-14b4756c2015"}],"id":"37ee9906-84d1-4631-8267-ee71b2ad7c3d","_postman_id":"37ee9906-84d1-4631-8267-ee71b2ad7c3d","description":""}],"variable":[{"key":"api_token","value":""}]}