Teamup Calendar API Examples
Number of APIs: 9
This is a Qodex collection of examples showing the use of the Teamup calendar API. This collection includes basic examples meant to help a new API user get started. To keep things simple, not all parameter and options are covered.
These examples complement our reference documentation at apidocs.teamup.com.
Teamup Support: support@teamup.com
Getting Started
Step 1) Fork the collection
To get started fork the collection from [Teamup's public workspace] within Qodex.
Enter a name for your fork and select the workspace where it will be created:

Step 2) Get your API key
To run requests you'll need to supply your secret API key and set it up as a variable of your forked collection.
- Go to https://teamup.com/api-keys/request and get your API key.
- Open the
Variables
tab of your forked collection and assign the obtained API key to variableapiKey
, as shown below:
Note that the API key must be submitted with every request as a header with name Teamup-Token
. All examples in this collection have this header set up already and it obtains the value from collection variable apiKey
.
Step 3) Submit a test requests
You should now be ready to make a first test request. The collection contains a test request with the name Test API
. If you sent this request and your API key is set up correctly, you will receive a status code 200 OK, as shown below.
Step 4) Get a test calendar
Now you are ready to start querying a calendar. You can use your own calendar or a demo calendar from our demo gallery.
All api requests require a calendar identifier or a secret calendar key to address a calendar. It is important to understand these two terms.
- A calendar identifier is a string of 6 characters that uniquely addresses a calendar. It is used if you plan to authenticate calendar users by username and passwords.
- A secret calendar key is string of 18 characters that can be used to access a calendar without any user login. When the secret calendar key is part of a URL it forms a secret URL. The technical term for this is a capability URL.
A calendar can have many secret URLs, each with different permissions. An example of a secret URL is this read-only URL of a demo calendar: https://teamup.com/ksmh1v99y2u1w168qn. In this example, the stringksmh1v99y2u1w168qn
is the secret key.
Since secret calendar keys are easy to use and work well for API use cases, we use them here for a first test of the API. To obtain a secret calendar key for your calendar go to Settings -> Sharing of your calendar. Use the button Create link
to create a new secret URL or use an existing URL. Extract the secret key from the URL:
Now go to the Variables
tab of your forked collection and assign the secret calendar key to variable calendarKeyOrId
, as shown below:
Step 5) Ready to test the API
You are now ready to use the provided API examples to query your calendar. Currently, the collection contain basic examples of all major API operations like reading events, creating events, updating events and deleting events. Try to get started with example Get events
, which reads the events for a specified date range from your calendar.
Note that each example has a documetation with some useful hints on its use. The example documentation can be opened in the right sidebar of Qodex as shown below:
We plan to add more advanced examples in the future. In case you run into any issues, you can reach us at support@teamup.com.
-
Configuration - Get the calendar configuration GET {{baseUrl}}/:calendarKey/configuration
-
Test API GET {{baseUrl}}/check-access
-
Events - Get events GET {{baseUrl}}/:calendarKeyOrId/events?startDate=2024-04-01&endDate=2024-04-07&tz=America/London
-
Events - Get event GET {{baseUrl}}/:calendarKeyOrId/events/:event_id?tz=Europe/London
-
Events - Delete event DELETE {{baseUrl}}/:calendarKeyOrId/events/:event_id
-
Events - Insert event POST {{baseUrl}}/:calendarKeyOrId/events?tz=Europe/London
-
Events - Update event PUT {{baseUrl}}/:calendarKeyOrId/events/:event_id?tz=Europe/London
-
Events - Undo PUT {{baseUrl}}/:calendarKeyOrId/events/undo/:undoId
-
Sub-Calendars - Get sub-calendars GET {{baseUrl}}/:calendarKeyOrId/subcalendars?includeInactive=false