Getting Started with the Teamwork.com API

Welcome to the Teamwork.com API. First things first, authentication is necessary for every request when using the Teamwork.com API.

If you are using the API for personal use, or to do some testing, Basic Auth will work.

If you are developing an application or integration for others to use, you should utilise our App Login Flow which implements OAuth 2.0.

We advise making all calls to your Teamwork account over SSL. If you have any security concerns or questions just drop us an email to security@teamwork.com.

Regardless of the chosen authentication method, you and your application's users will only have access and permission to the information that is accessible through their profile in Teamwork.com.

To get started, you will need your API key and your site URL to start using the API.

1. Open Teamwork.com.

2. Copy the URL from your address bar (ignoring /app...). This should be something like https://{yourSiteName}.teamwork.com. If you're using a custom domain, it might be something like https://projects.example.com.

US Hosted customers: https://{yourSiteName}.teamwork.com

EU Hosted Customers: https://{yourSiteName}.eu.teamwork.com

1. In Teamwork.com, click your avatar in the bottom left.

2. Click "Edit my details".

3. Go to "API & Mobile".

4. Click on the "Show your token".

5. Copy the "Key".

Any user (including Client users and collaborators) with an active seat in Teamwork.com can access the API. Access to data with the API is based on the users permissions and the features available with the subscription plan.

Feedback

If you have any feedback or suggestions, feel free to contact us at api@teamwork.com.