Asana

What it can do

• Read: Get the signed-in user, List workspaces, Get a workspace, List projects in a workspace, Get a project, List sections in a project, Get a section, List tasks in a project, Search tasks in a workspace, Get a task, List subtasks, List comments and activity on a task, Get a comment or story and List people in a workspace.
• Change: Create a task, Update a task, Mark a task complete, Move a task into a section, Create a section and Add a comment.

Comments are stories. Search tasks in a workspace works on a premium workspace. A person is chosen by id, not by email address. One list is one page. Rich text is not included. Asana's published permission list does not name listing, getting or creating a section, so those three may be refused. This app does not ask for full access.

What can start a workflow

• Task added, Task changed, Task deleted, Task removed from a parent, Comment added, Section added, Section changed and Project changed.
• Watch a project or a task. A workspace watch does not receive task, comment or section changes.
• An empty notice must be answered, or Asana removes the watch. A secret in the address is not accepted. Studio checks the signature on the raw notice.

How to connect

Open Connections, then Apps. In the Apps heading, search with Search apps to add and choose Add on Asana.

When the panel offers Who signs in, pick Sign in as the company (one account for every agent) or Each person signs in to their own account when first needed.

Read what it asks for. If it has not said, the panel says You'll see what Asana asks for on its own sign-in page. Choose Continue to Asana and finish there. Do not paste a password into Studio. When it works, the row says Connected.

If it says This app can't be connected here yet: it needs a sign-in setup this server doesn't have. or Connecting Asana opens soon on this server., this server cannot sign Asana in yet. If you do not see Add, ask an admin to add Asana.

What it asks for

• Read workspaces, projects, tasks, comments and people (workspaces:read, projects:read, tasks:read, stories:read, users:read).
• Create and update tasks (tasks:write). A write permission does not include the matching read.
• Read and write comments (stories:write as well as stories:read).
• Read, create and delete watches (webhooks:read, webhooks:write, webhooks:delete).