Create an App |
GuidesDeveloper PortalCreate an App

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.

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 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

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.


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


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

Read about updating your app details in our Developer Portal Permissions guide.

‘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.

Get your app verified…


If you have any feedback or suggestions, feel free to contact us at?

‹ Back to guides