Need more information? Get in touch with us – we love to chat
When your app is ready to be published, it’s time to get it verified by Teamwork. For this step, it’s essential that you provide us with a way to test your app and follow our verification checklist.
We check the app details entered in the Developer Portal.
It’s important that you use the credentials from the Developer Portal for authentication, we require all apps to use our App Login Flow. In order to successfully implement this, you need to pass in the client_id, client_secret along with the redirect_uri.
It’s important that when testing your app, you consent the app to the sharing of data. Consent screens look like this:
A new user signing into a 3rd party app will always get a consent screen the first time they log in. Once they consent to the app, the consent screen for that user won’t bother them again unless the app scopes are changed. In that case, the user will need to give consent for the new scope. Read more about consent screens in our full blog post here.
The most common issues we find with 3rd party apps when it comes to using our API is:
Your app should enhance the user’s experience. When they log in, they should not be met with drastic changes to their Teamwork account.
Your app should follow all Teamwork branding guidelines. Correct use of our brand can be found here.
Our privacy features are used by many of our users and ensuring our 3rd party apps respect that privacy is key. Depending on the app, we will check that permissions based tests are carried out. Read more about these scenarios here.
The app should work alongside Teamwork to enhance the user experience in both products. The app should be an integration and any actions should involve some interaction with Teamwork.
Once you are ready to publish your app, reach out to firstname.lastname@example.org to kick off the verification process. We will check the details on this checklist, and send the app to our QA team for testing. Please allow up to 5 working days to get a response from our team.
Once the QA team approve your app, we will set it to published! The status of the app will change in The Developer Portal to ‘Published’:
Once your app is approved and published, you can also get your app listed in our directory!
Get your app listed…
If you have any feedback or suggestions, feel free to contact us at email@example.com.