Jump to a Section

Overview

When you add an Asana card to a Flow for the first time, you’ll be prompted to configure the connection. You’ll be able to connect your Asana account, save your account information, and reuse the connection in new Flows that include Aaana. The Asana connector uses OAuth protocol.

Note: You can create multiple connections and manage them from your Settings page.

Create a new connection from an Event or Action card

  1. Click New Connection.
  2. Enter a Connection Nickname. This is useful if you plan to create multiple Asana connections to share with your team.
  3. Optionally, add a token in the Service Account Token field. This is necessary if you want to retrieve information such as secondary email addresses when using the Read User or Search User cards.
  4. Click Create.
  5. In the Sign In dialog, enter an email address and password, then click Sign In, to log in to your Asana account. Optionally, you can log in with a Google account, or use your corporate single sign-on credentials.
  6. Click Allow to authorize access to your Asana account.

Configure Asana connector in Workflows

Prerequisites

  • Okta Workflows admin credentials
  • Asana admin credentials

Procedure

  1. In the Okta Workflows Console, go to Settings > Connections.
  2. Click New Connection. Available connectors pop up in a window.
  3. Select Asana.
  4. Enter the Connection Nickname.
  5. Click Create. The Asana OAuth Login window opens.
  6. Sign in to Asana using admin credentials. You are prompted to authorize the Asana connector.
  7. Click Authorize.

The Asana connector is now cofigured and this connection is ready to be used with available action cards for the connector.

Deauthorize or Uninstall Asana connector in Workflows

You can delete individual Asana connections to deauthorize the Asana application connector or uninstall the entire Asana application connector.

Prerequisites

  • Okta Workflows admin credentials
  • Asana admin credentials

Delete a Asana connection in Workflows

Procedure

  1. In the Okta Workflows Console, go to Settings > Connections.
  2. Click Delete next to the connection you want to delete. Delete Connection window pops up.
  3. On the window, click Confirm.

The connection is now deleted.

Available scopes in the Asana connector

The scope default is the only available scope for the Asana connector.

    Actions

    • Add Task

      Create a new task within your Asana organization.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Options

      • Organization (dropdown): organizations in your Asana workspace

      Input

      Add To

      • Project ID: identifier of the project to which you will add a task
      • Project Section ID: identifier of the project section that contains your project

      Task

      • Task Name: name of the task
      • Description: description of the task
      • Parent Task ID: identifier of the parent task to which the current task belongs
      • Due On: due date (but not time) for the task in YYYY-MM-DD format.
        Note: this field will only output data when a due date is assigned to the task. Depending on whether the Due On or the Due At field contains a value, you may have to use the Assign If function to send the date value to another app.
      • Due At: due date and time for the task in ISO 8601.
        Note: this field will only output data when a task was assigned with a due date and a specified time. This means that you may have to use the Assign If function to send the due date to another app depending on whether the Due On or the Due At field has data.

      Note: Use only one of the Due On and Due At fields, not both.

      • Assignee: name of the user to whom the new task is assigned
      • Tags: tags assigned to the new task
      • Followers: users added to the new task with the role of follower

      Output

      • Task ID: identifier for the new task
      • Project Section ID: identifier for the project section that contains the task
    • Add User to Team

      Add a user to a team in your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      Team

      • Team ID: team’s unique identifier

      User

      • User ID or Email: user’s unique identifier or email; a user can also specify themselves using the string me

      Output

      Response

      • Status Code (number): success or failure of your HTTP request; here is a list of all status codes
    • Add Users to Project

      Add users to a project in your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      Project

      • Project ID: project’s unique identifier

      Users

      • User ID or Email: user’s unique identifier or email; a user can also specify themselves using the string me; to add multiple users, select click to add item for each additional user.

      Output

      Response

      • Status Code (number): success or failure of your HTTP request; here is a list of all status codes
    • Create Project

      Create a new project within your Asana organization.

      Unless otherwise indicated, field type is text.

      Options

      • Organization (dropdown): organizations in your Asana workspace

      Input

      Project

      • Name: name of the new project
        NOTE: You cannot create multiple projects with the same name. Use the Search Project action to make sure you aren’t duplicating project names.
      • Due On (date): due date for the new project. You can format the date in one of two ways:
        • To specify a date only, the format must be YYYY-MM-DD
        • To specify a date and time, the format must be YYYY-MM-DDTHH:mm:ss+00:00
      • Public? (boolean): indicates whether the project is accessible by team members; True if the project should be visible by all team members, or False if the project is restricted.
      • Description: description of the new project

      Status: Indicate the status of a project by either color or description or both

      NOTE: Status is not required to create a project. A project status is added or updated if you provide values for both the Status Color and Description when you create or update a project.

      • Status Color: color that represents the status of the new project; options are On Track, At Risk, Off Track, or On Hold
      • Description: description of the project’s status

      Tip: Find a Team ID or the User ID of a project owner by searching for a Team Name or Owner Name

      Team

      • Team ID (number): numeric identifier of the team to whom the new project is assigned.
        NOTE: This field is required. Find a team’s identifier by navigating to Team Conversations. The identifier can be found in the team’s URL.
      • Team Name: name of the team to whom the project is assigned

      Note: Team ID is a required field if you select an organization from the Options > Organization dropdown. You need to identify the team with which you’ll share the project.

      Owner

      • User ID (number): numeric identifier of the user to whom the new project is assigned
      • Owner Name: name of the user to whom the new project is assigned

      Output

      • Project ID (number): numeric identifier of the new project
    • Create User

      Add a new user to your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      User

      • Name: new user’s name
      • Primary Email: user’s primary email address
      • Secondary Emails: one or more of the user’s secondary email addresses; for each email address, select click to add item.

      Output

      Response

      • User ID: new user’s Asana unique identifier
    • Custom API Action

      Make a custom, authenticated HTTP call to the Asana API.

      Options

      • Request Type (dropdown): use the appropriate request type depending on the endpoint/method
        • GET
        • POST
        • PUT
        • PATCH
        • DELETE

      Input

      • Relative URL (text): Specify the relative URL as /api/<version>/{insert_remaining_URL}. You can specify query parameters in the relative URL using “?”, or specify the query parameters as an object key pair in the Query input.

        Example: https://app.asana.com/api/1.0/{{input.Request.Relative URL}}

      • Query (object): Specify any additional query parameters that should be included in object format (key value pairs).

      • Headers (object): Specify any headers required in addition to authorization or content-type (these are already handled by this connector).

      • Body (object): Specify a request body in JSON format. Only available for POST, PUT, and PATCH requests.

      Output

      Response

      • Status Code (number): success or failure of your HTTP request. Here is a list of all status codes.
      • Headers (object): a detailed context for the status code, unrelated to the output body. Response headers are dependent on your selected HTTP request option. Note that not all headers are response headers. This will usually be a replica of the example below.

        Example: {"Content-type":"application/json"}
      • Body (object): data returned from your selected HTTP request (for example, the data from a GET request).

    • Deactivate User

      Deactivate a user in your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      User

      • User ID: user’s unique identifier

      Output

      Response

      • Status Code (number): success or failure of your HTTP request; here is a list of all status codes
    • List Tasks

      List tasks in your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Options

      • Result Set (dropdown):
        • First Matching Task: returns the first task that meets the search criteria
        • All Matching Tasks: returns all tasks that match the search criteria
      • Filter By (dropdown): filter the task result set; options are Project, Project Section, Tag, or Assignee and Workspace

      Input

      Task
      NOTE: The input fields that appear in the Task section are dependent on the options that you selected.
      * Project ID: identifier of the project that contains the task * Project Section ID: identifier for the section that contains a task * Tag (dropdown): tag that is assigned to a task * Workspace (dropdown): name of the workspace that contains the task * Assignee: identifier of the user to whom a task is assigned * Completed Since (date): only returns tasks that are either incomplete or that have been completed since this time * Modified Since (date): only returns tasks that have been modified since this time

      Output

      Tasks * Task ID: identifier of a task * Task Name: name of a task * Description: description of a task * Time Created (date): date and time when a task was created in ISO 8601 * Time Modified (date): date and time when a task was last modified in ISO 8601 * Completed? (boolean): True/False value indicating whether a task was completed or not * Time Completed (date): date and time when a task was completed. Data will be displayed only if the field Completed? contains the value of True. * Due On (date): due date (but not time) for a task in YYYY-MM-DD format
      NOTE: this field will only output data when a due date is assigned to the task
      * Due At (date): due date and time for a task in ISO 8601
      NOTE: this field will only output data when a task was assigned with a due date and a specified time
      * Workspace ID: identifier of the workspace that contains the task
      * Workspace Name: name of the workspace that contans the task
      * Project ID: identifier of the project that contains the task * Project Name: name of the project that contains the task * Section ID: identifier for the section that contains a task * Section Name: name for the section that contains a task * Parent Task ID: identifier of the parent task to which a task belongs * Assignee ID: unique identifier of the user to whom a task is assigned * Assignee Name: name of the user to whom a task is assigned * Attachment IDs: identifiers of attachments to the task * Tags: tags assigned to a task * Followers: users that are added to a task with the role of follower * User ID: unique identifier of the task follower * Name: name of the task follower

    • Read Project

      Read a project’s data.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      Read By

      • Project ID (number): unique numeric identifier of the project

      Output

      Project

      • Name: name of the project
      • Description: description of the project
      • Time Created (number): date and time when the project was created in ISO 8601
      • Time Updated (number): date and time when the project was last updated in ISO 8601
      • Due Date (date): due date for the new project. The value will appear in one of the following two formats:
        • If the project is due on a date, the format will be YYYY-MM-DD
        • If the project is due on a specific time of day, the format will be YYYY-MM-DDTHH:mm:ss+00:00
      • Archived? (boolean): indicates whether the project is archived; True if the project is archived, or False if it is not archived
      • Public? (boolean): indicates whether the project is accessible by team members; True if the project should be visible by all team members, or False if the project is restricted.

      Status

      • Status Color: color that represents the status of the new project; green for On Track, yellow for At Risk, red for Off Track, or blue for On Hold
      • Description: description of the project’s status

      Owner

      • User Name: name of the user to whom the project is assigned
      • User ID (number): numeric identifier of the user to whom the project is assigned

      Team

      • Team Name: name of the team to whom the project is assigned
      • Team ID (number): numeric identifier of the team to whom the project is assigned

      Members

      • Member ID (number): numeric identifier of members of the project
      • Member Name: names of the members of the project
    • Read Project Tasks

      Read tasks associated with a project.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      Project

      • Project ID (number): unique numeric identifier of the project

      Output

      Tasks * Task ID: identifier for a task * Task Name: name of a task * Description: description of a task * Time Created (date): date and time when a task was created in ISO 8601 * Time Modified (date): date and time when a task was last modified in ISO 8601 * Completed? (boolean): True/False value indicating whether a task was completed or not * Time Completed (date): date and time when a task was completed. Data will be displayed only if the field Completed? contains the value of True. * Due On (date): due date (but not time) for a task in YYYY-MM-DD format
      NOTE: this field will only output data when a due date is assigned to the task. * Due At (date): due date and time for a task in ISO 8601
      NOTE: this field will only output data when a task was assigned with a due date and a specified time * Project Section ID: identifier for the section that contains a task * Project Section Name: name for the section that contains a task * Parent Task ID: identifier of the parent task to which a task belongs * Assignee ID: unique identifier of the user to whom a task is assigned * Assignee Name: name of the user to whom a task is assigned * Tags: tags assigned to a task * Followers: users that are added to a task with the role of follower * User ID: unique identifier of the task follower * Name: name of the task follower

    • Read User

      Read a user profile.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      User * User ID or Email: unique identifier or email address associated with the user; to use a user ID as input, you must have an Enteprise Asana account.

      Output

      Fields * User ID: unique numeric identifier of the user * Name: full name of the user * Email: user’s email address * Secondary Emails: one or more of the user’s secondary email addresses; values will be returned if you provided a Service Account Token when authorizing a connection for the Asana connector. * Workspaces: workspaces with which the user is associated

    • Read User Tasks

      Read a user task in your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Options

      • Organization (dropdown): organizations in your Asana workspace
      • Read Tasks (dropdown):
        • My Tasks: returns all tasks assigned to you
        • One by ID: returns a single task by its unique identifier
        • All Tasks: returns all tasks for the selected organization

      Input

      • User
        • User ID: user’s unique identifier
      • Task (available if you choose the option One by ID from the Read Tasks dropdown)
        • Task ID: identifier for the task

      Output

      • Result
        • Task ID: identifier for the task
        • Task Name: name of a task
        • Description: description of a task
        • Time Created (date): date and time when a task was created in ISO 8601
        • Time Modified (date): date and time when a task was last modified in ISO 8601
        • Completed? (boolean): True/False value indicating whether a task was completed or not
        • Time Completed (date): date and time when a task was completed. Data will be displayed only if the field Completed? contains the value of True.
        • Due On (date): due date (but not time) for a task in YYYY-MM-DD format
          NOTE: this field will only output data when a due date is assigned to the task
        • Due At (date): due date and time for a task in ISO 8601
          NOTE: this field will only output data when a task was assigned with a due date and a specified time.
        • Workspace ID: identifier of the workspace that contains the task
        • Workspace Name: name of the workspace that contans the task
        • Project ID: identifier of the project that contains the task
        • Project Name: name of the project that contains the task
        • Section ID: identifier for the section that contains a task
        • Section Name: name for the section that contains a task
        • Parent Task ID: identifier of the parent task to which a task belongs
        • Assignee ID: unique identifier of the user to whom a task is assigned
        • Assignee Name: name of the user to whom a task is assigned
        • Attachment IDs: identifiers of attachments to the task
        • Tags: tags assigned to a task
        • Followers: users that are added to a task with the role of follower
          • User ID: unique identifier of the task follower
          • Name: name of the task follower
    • Remove User to Team

      Remove a user from a team in your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      Team

      • Team ID: team’s unique identifier

      User

      • User ID or Email: user’s unique identifier or email; a user can also specify themselves using the string me

      Output

      Response

      • Status Code (number): success or failure of your HTTP request; here is a list of all status codes
    • Remove Users to Project

      Remove users from a project in your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      Project

      • Project ID: project’s unique identifier

      Users

      • User ID or Email: user’s unique identifier or email; a user can also specify themselves using the string me; to remove multiple users, select click to add item for each additional user.

      Output

      Response

      • Status Code (number): success or failure of your HTTP request; here is a list of all status codes
    • Search Projects

      Search a project by name to find the project’s ID.

      Unless otherwise indicated, field type is text.

      Options

      • Organization (dropdown): organizations in your Asana workspace
      • Result Set (dropdown):
        • First Matching Project: first project that matches search criteria
        • All Matching Projects: all projects that match search criteria

      Input

      • Search By
        • Project Name: name of the project for your query

      Output

      • Projects
        • Project Name: name of the project based on your query
        • Project ID (number): unique identifier of the project in your search results
    • Search Tasks

      Search for a task in your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Note: This action card is available for Asana accounts with Premium access or higher.

      Options

      • Organization (dropdown): organizations in your Asana workspace
      • Result Set (dropdown):
        • First Matching Task: returns the first task that meets the search criteria
        • All Matching Tasks: returns all tasks that match the search criteria

      Input

      Task * Text: option for full-text search on both a task name and description * Assignee Any (list of text): identifier of the user to whom a task is assigned * Projects Any (list of text): identifier of the project that contains the task * Project Sections Any (list of text): identifier for the section that contains a task * Tags Any (list of text): identifier of the tag that is assigned to a task * Teams Any (list of text): identifier of the team that is assigned to a task * Followers Any (list of text): identifier of the follower of a task * Created By Any (list of text): identifier of the creator of a task * Assigned By Any (list of text): identifier of the assigner of the task * Created At After (date): only returns tasks that are created after this time * Completed At After (date): only returns tasks that have been completed after this time * Modified At After (date): only returns tasks that have been modified after this time * Is Blocking? (boolean): indicates whether task has dependents * Is Blocked? (boolean): indicates whether task has dependencies * Has Attachment? (boolean): indicates whether task has attachments * Completed? (boolean): indicates whether task is completed * Sort By (dropdown): key to sort tasks; options are due_date, created_at, completed_at, likes, or modified_at; default is modified_at

      Output Fields

      Note: A maximum of 100 tasks can be returned.

      Tasks * Task ID: identifier of a task * Task Name: name of a task

    • Search Teams

      Search for Teams in Asana using the Team Name

    • Search User

      Search a user by name or email to find the user’s Asana ID.

      Unless otherwise indicated, field type is text.

      Options

      • Organization (dropdown): organizations in your Asana workspace

      Input

      User * Name: name of the user for your query * Email: email address of the user for your query

      Output

      Result * Name: name of the user; if a user’s name is updated, the updated value will only be returned if you provided a Service Account Token when authorizing a connection for the Asana connector. * Email: email address of the user * User ID: unique Asana identifier of the user

    • Update Project

      Update an existing project in your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Options

      • Organization (dropdown): organizations in your Asana workspace

        Note: This action is only compatible with organizations. If you do not see your workspace in the menu, then it may not be an organization. To learn about the difference between workspaces and organizations, see https://asana.com/developers/api-reference/workspaces.

      Input

      Note: Any data that you add to a field will overwrite existing data in the project. The Update Project action card will disregard any input fields that are left empty or populated with null values, and such values will not be sent to the Asana API.

      Update By

      • Project ID (number): unique identifier of the project you want to update. This field is required.

      Project

      • Name: new name of the project. You can have multiple projects with the same name
      • Due On (date): new due date for the project. You can format the date in one of two ways:
        • To specify a date only, the format must be YYYY-MM-DD
        • To specify a date and time, the format must be YYYY-MM-DDTHH:mm:ss+00:00
      • Public? (boolean): indicates whether the project is accessible by team members; True if the project should be visible by all team members, or False if the project is restricted
      • Archived? (boolean): indicates whether the project is archived; True if the project is archived, or False if it is not archived
      • Description: new description of the project

      Status

      You can indicate the status of a project by either color or description or both

      Note: A project status is added or updated if you provide values for both the Status Color and Description when you create or update a project.

      • Status Color: color that represents the status of the new project; options are On Track, At Risk, Off Track, or On Hold
      • Description: new description of the project’s status

      Tip: Find a Team ID or the User ID of a project owner by searching for a Team Name or Owner Name

      Team

      • Team ID (number): new numeric identifier of the team to whom the project is assigned
      • Team Name: new name of the team to whom the project is assigned

      Owner

      • User ID (number): new numeric identifier of the user to whom the project is assigned
      • Owner Name: new name of the user to whom the project is assigned

      Output

      • Status Code (number): success or failure of your HTTP request; here is a list of all status codes
    • Update Task

      Update data for a task.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      Note: The Update Task action card will disregard any input fields that are left empty or populated with null values, and such values will not be sent to the Asana API.

      Task

      • Task ID: identifier of the task that you want to update
      • Project ID: identifier for the project that contains the task
      • Project Section ID: identifier for the project section that contains the task
      • Name: name of the task
      • Description: description of the task
      • Assignee: unique numeric identifier of the team member to whom the task is assigned
      • Due On (date): due date (but not time) for the task in YYYY-MM-DD format
        Note: this field will only output data when a due date is assigned to the task
      • Due At (date): due date and time for the task in YYYY-MM-DDTHH:mm:ss+00:00 format
        Note: this field will only output data when a task was assigned with a due date and a specified time

      Note: Use only one of the Due On and Due At fields, not both.

      • Completed? (boolean): True/False value indicating whether a task was completed or not

      Output

      Response

      • Status Code (number): success or failure of your HTTP request; here is a list of all status codes
    • Update User

      Update a user’s information in your Asana instance.

      Unless otherwise indicated, field type is text.

      Required fields are indicated by a red asterisk.

      Input

      User

      • User ID: user’s unique identifier
      • Name: user’s name
      • Primary Email: user’s primary email address
      • Secondary Emails: one or more of the user’s secondary email addresses; for each email address, select click to add item.

      Output

      Response

      • Status Code (number): success or failure of your HTTP request; here is a list of all status codes