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 the Callback URL from your Connector Profile
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 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 Current User, Get Custom Field, Get Events, Get Goal, Get Membership, 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.
Create the StackOne Connector Profile
1
Create a Connector Profile
Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2
Link an Account
Once the Connector Profile is created, continue to link an account.