Asana

Setup Guide

You can find your Asana app credentials by visiting your Asana Developer App Console.

You'll need the following information to set up your Asana app with Paragon:

  • Client ID

  • Client Secret

Add the Redirect URL to your Asana app

Paragon provides a redirect URL to send information to your Asana app. To add the redirect URL to your Asana app:

1. Copy the link under "Redirect URL" in your integration settings in Paragon. The Redirect URL is:

https://passport.useparagon.com/oauth

2. Log into your Asana Developer App Console.

3. Select the Asana application you'd like to connect to Paragon.

4. Under Authorization > Redirect URLs, paste the Redirect URL provided in Step 1.

Note: You'll need to create a new Asana app if you don't already have one

Asana provides you with the Client ID and Client Secret needed for the next steps after adding the redirect URL to your project.

Add your Asana app to Paragon

1. Select Asana from the Integrations Catalog.

2. Under Integrations > Connected Integrations > {YOUR_APP} > Settings, fill out your credentials from the end of Step 1 in their respective sections:

  • Client ID: Found at the end of Step 1.

  • Client Secret: Found at the end of Step 1.

Press the blue "Connect" button to save your credentials.

Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.

Connecting to Asana

Once your users have connected their Asana account, you can use the Paragon SDK to access the Asana API on behalf of connected users.

See the Asana REST API documentation for their full API reference.

Any Asana API endpoints can be accessed with the Paragon SDK as shown in this example.

// You can find your project ID in the Overview tab of any Integration
// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
// List files
await paragon.request("asana", "tasks", {
method: "POST",
body: {
"name": "Water the plants",
"due_on": "2019-09-15"
}
});

Building Asana workflows

Once your Asana account is connected, you can add steps to perform the following actions:

  • Create Comment

  • Create Project

  • Get Projects

  • Get Project by ID

  • Create Task

  • Update Task

  • Get Tasks

  • Get Task by ID

  • Get Teams

  • Get Workspaces

When creating or updating tasks in Asana, you can reference data from previous steps by typing {{ to invoke the variable menu.