Skip to main content

​
Authentication Method

​
Personal Access Token Setup

​
Step 1: Create a Personal Access Token

  1. Log in to Asana
  2. Click your profile photo → My Settings
  3. Go to the Apps tab
  4. Click Manage Developer Apps
  5. Under Personal access tokens, click + New access token
  6. Give it a name and click Create token
  7. Copy the token immediately — you won’t be able to see it again
  8. 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

CredentialRequired ForWhere to Find
Personal Access TokenAll API callsMy Settings → Apps → Personal access tokens
Webhook SecretWebhook verificationReturned when creating webhook
For general information about how Corsair handles authentication, see Authentication.