Create an App

Creating an app is easy. Simply fill in the details of the app and from there gain access to your Client ID and Client Secret used in authenticating using our App Login Flow.

Note: You need to be signed into your developer portal to create an app. If you have not logged in yet, please refer to how do I get access to my developer portal

App Details:

  • Name – The name of your app, this will show on your apps consent screen

  • Icon – Icon shown to users during authentication and installation

  • Description – What the app will do

  • Product – Which Teamwork.com products your app intends to use, you must select at least one. You may update this in the future but adding new products will require you to re-authenticate to access APIs under the new scopes

  • Redirect URLs – Return URI for your app, you must add at least one Redirect URL

Create App Modal

Once you enter your main app details, you’re all set!

When you select the app, you will be able to access the data you need to get started. The app screen has 2 main tabs.

General

These are the main details of the app.

  • Name – Name of your app which you entered on creation

  • Owner – Name of the user who created the app

  • Icon – Icon shown to users during authentication and installation

  • URL – Link to public page about your app

  • Description – Your public app description

Credentials

You’ll find all the data needed here in order to authenticate using our App Login Flow. You can manage your scopes and add new redirect URIs.

  • Client ID – Unique ID for authentication, passed in the client_id parameter

  • Client secret – Authentication secret, passed under client_secret parameter

  • Products – Which products’ data your app needs to access

  • Redirect URls – List of allowed URIs to redirect to when authentication is complete or has failed. These must be secure URIs with https only unless they are using localhost or it will return an error

  • Origins – Option list of origins allowed to complete the authentication flow

‘In development’ App Status

This means your app is currently in development mode and it can only be used by the Teamwork account it was created under. Once you are ready to publish your app and make it available to all Teamwork users, read our app verification section. This will to help you speed up the verification process, getting your app approved on the first review.

Feedback

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