Integrating Asana with BetterCloud

Follow

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 authentication type when integrating with Asana:

  • API Token

You will also need to enter the following additional headers 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.”

Asana-1.png

Select the Apps tab.

Asana-2.png

Click Manage Developer Apps.

Asana-3.png

Find the “New access token” option.

Asana-4.png

Name and create your token.

Asana-5.png

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.

Asana-6.png

When entering your Asana API token in BetterCloud, be sure to prepend the required "Bearer" prefix:

Image_2019-10-07_at_3.25.48_PM.png

Workspace GID

Your workspace GID is the unique ID associated with the Asana workspace you are going to be integrating with BetterCloud, and must be entered as the header called asanaWorkspaceGid. There are a few ways to retrieve your ID, but the following method is the most reliable. It will consist of making a simple get call in the Asana API explorer to retrieve the workspace ID.

To start, navigate to the Asana developer portal. From here you will need to head to the “Explorer” tab, and authorize the API explorer.

Asana-7.png

Once you’ve granted permissions you are ready to run your call. Leaving the rest of the information on the page as-is, scroll down to the attribute parameters. Verify that the correct workspace is selected, and click “Submit."

Asana-8.png

The response will reveal the “gid” for the workspace. Copy this value.

Asana-9.png

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