Asana Actions integration

Back to list of integrations Use the Asana integration to let agents create tasks and call the Asana API through Action Tools. Artemis authenticates with OAuth 2.0.

Authentication	Actions	Workflow triggers
OAuth 2.0	2	None

Supported actions

Actions are Asana operations that an agent runs as Action Tools during a conversation. You can also run them from an Integration node in a workflow.

Action	Use it to
Create Task	Create a task in an Asana project.
Custom API Call	Call an Asana API endpoint that the other actions don’t cover.

Prerequisites

An Asana account with access to the workspaces and projects that agents use.
An OAuth app in the Asana developer console. See OAuth.

Set up the integration

Create an Asana OAuth app

In the Asana developer console, create an app. Add the Callback URL from the Artemis profile form to the app’s redirect URLs, and copy the Client ID and Client Secret.

Create the auth profile

In Integrations, select Asana > Connect. On Project Auth Profiles, select New Profile > Integration Profile > Asana > Continue.

Field	Value
Profile Name	A name for the profile, for example `Asana - Production`
Usage Mode	Preconfigured (default), JIT (Just-in-Time), or Preflight. With Preconfigured, an admin provides credentials at setup, and users don’t authorize. See Auth profiles.
Authorization URL, Token URL, Refresh URL	Pre-filled with the Asana endpoints. Keep the defaults.
Scopes	Pre-filled with `default`.
Callback URL	Read only. Add it to your Asana app’s redirect URLs.
Client ID, Client Secret	From your Asana app.

Select Create Profile, and complete the Asana sign-in and consent when prompted.

Create the action tool

In Tools, open the Actions tab and select Create Tool. Enter a Tool Name and Description, and select Select Integration > Asana > Continue. Select the Action and Auth Profile, set parameter defaults (leave a value empty for the agent to supply at runtime), choose an output mode, and select Create Tool. Then assign the tool to an agent.

Action reference

Create Task

Creates a task in an Asana project.

Parameter	Type	Description
`workspace`	enum	Workspace to create the task in.
`project`	enum	Project to create the task in.
`name`	string	Task name.
`notes`	string	Task description.
`due_on`	string	Due date. Accepts any date format.
`tags`	array	Tags to add to the task.
`assignee`	enum	User to assign the task to.

Custom API Call

Sends a request to an Asana API endpoint. Artemis adds the authorization headers from the auth profile.

Parameter	Type	Description
`url`	object	Endpoint URL.
`method`	enum	HTTP method.
`headers`	object	Request headers. Authorization headers are added automatically.
`queryParams`	object	Query parameters.
`body_type`	enum	Body type. Default: `None`.
`body`	object	Request body.
`response_is_binary`	boolean	Returns the response as a file. Use for PDFs, images, and other files. Default: `False`.
`failsafe`	boolean	Returns a result instead of an error when the request fails.
`timeout`	number	Timeout, in seconds.
`followRedirects`	boolean	Follows HTTP redirects. Default: `False`.

Troubleshoot common issues

Issue	Resolution
Authorization fails with a redirect error	Confirm the Asana app’s redirect URLs include the exact Callback URL from the profile form.
The profile status stays Awaiting authorization	Complete the Asana sign-in and consent in the same browser session.
`invalid_client`	Copy the Client ID and Client Secret again from the Asana developer console.
The workspace, project, or assignee list is empty	Confirm the authorizing user is a member of the workspace and has access to the project.
The task isn’t assigned	Confirm the assignee is a member of the selected workspace.

Related articles:

​Supported actions

​Prerequisites

​Set up the integration

​Action reference

​Troubleshoot common issues

Supported actions

Prerequisites

Set up the integration

Action reference

Troubleshoot common issues