Get Credentials

Authentication Method

api_key - Personal access token

Personal Access Token Setup

Step 1: Create a Personal Access Token

Log in to Asana
Click your profile photo → My Settings
Go to the Apps tab
Click Manage Developer Apps
Under Personal access tokens, click + New access token
Give it a name and click Create token
Copy the token immediately — you won’t be able to see it again
Store it securely

Storing Credentials:

pnpm corsair setup --plugin=asana api_key=your-personal-access-token

Webhook Setup (Optional)

Asana webhooks are managed through the API. Use Corsair to create a webhook subscription:

await corsair.asana.api.webhooks.create({
    resource: "project-id",
    target: "https://yourapp.com/webhooks/asana",
    filters: [{ resource_type: "task", action: "added" }],
});

Store the webhook secret for signature verification:

pnpm corsair setup --plugin=asana webhook_signature=your-webhook-secret

Required Credentials Summary

Credential	Required For	Where to Find
Personal Access Token	All API calls	My Settings → Apps → Personal access tokens
Webhook Secret	Webhook verification	Returned when creating webhook

For general information about how Corsair handles authentication, see Authentication.

Overview

Plugins

Get Credentials

Authentication Method

Personal Access Token Setup

Step 1: Create a Personal Access Token

Webhook Setup (Optional)

Required Credentials Summary

​Authentication Method

​Personal Access Token Setup

​Step 1: Create a Personal Access Token

​Webhook Setup (Optional)

​Required Credentials Summary

Authentication Method

Personal Access Token Setup

Step 1: Create a Personal Access Token

Webhook Setup (Optional)

Required Credentials Summary