Skip to main content
You need appropriate permissions in your Asana workspace to create OAuth applications. Some enterprise workspaces may require IT admin approval.

​
Prerequisites

Verify you have the necessary permissions before starting setup.

  • Admin or appropriate permissions in your Asana workspace.
  • Access to create applications in the Asana Developer Console.

​
Create OAuth application

Register an OAuth application in the Asana Developer Console.

1

Sign in to Asana

Sign in to your Asana account.

  • Click your profile avatar in the top-right corner and select Settings.
  • Navigate to the Apps tab.
  • Scroll to Build new apps and click View developer console.
2

Create a new app

Click + Create new app in the Developer Console.

  • Enter an App name (e.g., StackOne Integration).
  • Select API app as the app type.
  • Check the box I agree to the Asana API Terms.
  • Click Create app.

​
Configure OAuth settings

Set up the redirect URL and permission scopes for your application.

1

Add redirect URL

Navigate to the OAuth tab in your app settings.

  • In the Redirect URLs section, click + Add redirect URL.
  • Enter exactly: https://api.stackone.com/connect/oauth2/asana/callback
2

Configure permission scopes

Enables actions: Add Custom Field To Portfolio, Add Custom Field To Project, Add Dependencies, Add Dependents, Add Followers To Project, Add Followers To Task, Add Item To Portfolio, Add Members To Project, Add Project To Task, Add Subgoal, Add Tag To Task, Add Task To Section, Add User To Team, Add User To Workspace, Create Custom Field, Create Enum Option, Create Goal, Create Membership, Create Organization Export, Create Portfolio, Create Project, Create Section, Create Status Update, Create Story, Create Subtask, Create Tag, Create Task, Create Time Tracking Entry, Create Webhook, Delete Attachment, Delete Goal, Delete Membership, Delete Portfolio, Delete Project, Delete Section, Delete Status Update, Delete Story, Delete Task, Delete Time Tracking Entry, Delete Webhook, Duplicate Project, Duplicate Task, Get Attachment, Get Audit Log Events, Get Current User, Get Custom Field, Get Events, Get Goal, Get Membership, Get Organization Export, Get Portfolio, Get Portfolio Items, Get Project, Get Project Tasks, Get Project Template, Get Section, Get Status Update, Get Story, Get Tag, Get Task, Get Task Template, Get Tasks From User Task List, Get Team, Get Team Users, Get Time Period, Get Time Tracking Entry, Get User, Get User Favorites, Get User Task List, Get User Team Memberships, Get User Teams, Get User Workspace Memberships, Get Webhook, Get Workspace, Instantiate Project Template, Instantiate Task From Template, List Attachments, List Custom Fields, List Goals, List Memberships, List Portfolios, List Project Templates, List Projects, List Sections, List Status Updates, List Stories, List Subtasks, List Tags, List Task Templates, List Tasks, List Teams, List Time Periods, List Time Tracking Entries, List Users, List Webhooks, List Workspaces, Remove Custom Field From Portfolio, Remove Custom Field From Project, Remove Dependencies, Remove Dependents, Remove Followers From Project, Remove Followers From Task, Remove Item From Portfolio, Remove Members From Project, Remove Project From Task, Remove Subgoal, Remove Tag From Task, Remove User From Team, Remove User From Workspace, Search Tasks, Set Parent Task, Typeahead Search, Update Custom Field, Update Enum Option, Update Goal, Update Membership, Update Portfolio, Update Project, Update Section, Update Story, Update Tag, Update Task, Update Team, Update Time Tracking Entry, Update Webhook, Update Workspace

Select the required permissions for the integration. Enable Full permissions for all scopes, or select individual scopes below.

3

Copy Client credentials

Navigate to the Basic information tab and scroll to the App credentials section.

  • Copy the Client ID.
  • Click Copy next to the Client Secret.
  • Store both values securely for use later — if the secret is regenerated, existing integrations will need updating.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Asana:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Asana
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Asana.