Create an App | Developer.Teamwork.com
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.

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
  • Origins – Option list of origins allowed to complete the authentication flow

‘In development’ App Status

The app is currently in development mode and will only available for your Teamwork account.
If you would like to publish your app and make it available for everyone, please contact integrations@teamwork.com.

What’s next?

As our Developer Portal is in Beta, we will take the process from here. Once you are ready to publish your integration, please reach out to integrations@teamwork.com and we can help.

Feedback

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

‹ Back to guides