Integrating Asana with BetterCloud



When integrating a new application with your BetterCloud instance, the overall installation process is consistent. However, each integration is different and may require varying levels and types of authentication. This article provides instructions for configuring and collecting all the information you need in order to add the Asana integration in BetterCloud. 

BetterCloud requires the following when integrating with Asana:

You will also need to enter the following additional environment variable in order to successfully connect:

  • asanaWorkspaceGid

API Token

When adding the Asana integration you must enter a valid API token. To generate an API token, please take the following steps within Asana:

Select your profile from the top right corner of the page, and navigate to “My Profile Settings.”


Select the Apps tab.


Click Manage Developer Apps.


Find the “New access token” option.


Name and create your token.


On the next page you will be presented with your API token. Be sure to copy it here, since you will not be able to access it again.


Prepend the required "Bearer " prefix when entering your Asana API token into BetterCloud.

Note: A space is required after Bearer. Your entry should look similar to this:

Bearer 1/92312XXXXX65323:98abXXXXXXXc19



Workspace GID (While Under Maintenance)

The Asana API explorer is currently under maintenance. However, you are able to get the GID of your workspaces by visiting and copying it from there.


Once you have successfully added the integration, your workspace GID will be available as an encrypted environment variable in your integration and can be updated at any time. Your API token can also be updated from the basic information section.


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request