Steps
-
Create an Asana Developer App
- Go to the Asana Developer Apps page
- Log in with your Asana account
- Click + New App in the developer console
-
Configure the App
- Fill in:
- App Name: e.g.,
My Asana Integration - App Website: (optional)
- Redirect URL: Your OAuth callback URL
- App Name: e.g.,
- Save the app
- Fill in:
-
Get Client ID and Client Secret
- After creation, Asana will provide the Client ID and Client Secret
- Copy them and store securely
-
Configure OAuth Scopes
- Asana requires the
defaultscope for basic access - Granular scopes are also available:
tasks:read/tasks:write— Task dataprojects:read/projects:write— Project dataworkspaces:read— Workspace information
- Configure scopes in your OAuth authorization request
- Asana requires the
Key Details
- Developer Portal: https://asana.com/developers
- App Console: https://app.asana.com/0/developer-console
- Auth Type: OAuth 2.0
- Authorization URL:
https://app.asana.com/-/oauth_authorize - Token URL:
https://app.asana.com/-/oauth_token - Base API URL:
https://app.asana.com/api/1.0 - Credentials Location: Developer Console → App settings
- Common Scopes:
default,tasks:read,tasks:write,projects:read,projects:write,workspaces:read