Asana
Connect to your users’ Asana accounts.
Setup Guide
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:
1
https://passport.useparagon.com/oauth
Copied!
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.
Any Asana API endpoints can be accessed with the Paragon SDK as shown in this example.
1
// You can find your project ID in the Overview tab of any Integration
2
3
// Authenticate the user
4
paragon.authenticate(<ProjectId>, <UserToken>);
5
6
// List files
7
await paragon.request("asana", "tasks", {
8
method: "POST",
9
body: {
10
"name": "Water the plants",
11
"due_on": "2019-09-15"
12
}
13
});
Copied!
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.Using Webhook Triggers
Webhook triggers can be used to run workflows based on events in your users' Asana account. For example, you might want to trigger a workflow whenever tasks are updated to sync your users' Asana Tasks to your application in real-time.
You can find the full list of Webhook Triggers for Asana below:
- New Task
- Task Updated
- Task Completed
- Tag Added
- New Project
- New Comment
Last modified 1mo ago