Skip to main content

create_task

Facts​

DescriptionCreate a task
SchemaConnectors.Asana.functions.CreateTask
ServiceAsana

Input parameters​

Required input parameters

asana_access_tokenslack#/types/credential/oauth2Required

Asana Access token. See the authentication section for details.

namestringRequired

A concise name for this task

Examples
Create _Starring Sandra_ video collection
projectstringRequired

The globally unique identifier of the project to add a task to

Examples
0fb0abc-1qwe234-asdf1234-zxcv0987
workspace_gidstringRequired

The globally unique identifier for the workspace or organization

Examples
02af8431-baa5-42d5-86ee-4fa270c5ef32

Optional input parameters

assigneeslack#/types/user_idOptional

The Slack user ID of the person to assign this task to

collaboratorsarrayOptional

A comma-separated array of Slack user IDs to be added as project followers. In Asana, followers are a subset of members who have opted in to receive 'tasks added' notifications for a project.

descriptionstringOptional

Free-form text describing this task

due_atslack#/types/timestampOptional

The date and time when this task is due, as a Unix timestamp

start_atslack#/types/timestampOptional

The date and time when this task should start, as a Unix timestamp

tagsarrayOptional

A comma-separated array of globally unique tag identifiers

Output parameters​

Required output parameters

permalink_urlstringRequired

Link to task

task_namestringRequired

Task name

Optional output parameters

assigneestringOptional

The Slack user ID of the person to assign this task to

collaborator_emailsarrayOptional

Collaborator emails

created_atstringOptional

Created at

descriptionstringOptional

Free-form text describing this task

due_atstringOptional

The date and time when this task is due, as a Unix timestamp

start_atstringOptional

The date and time when this task starts, as a Unix timestamp

task_gidstringOptional

Unique ID of the newly created task

Authentication​

End-user authentication

User workflows that include a connector function relying on end-user authentication can only be started with a link trigger.

{
  "asana_access_token": {
    "credential_source": "END_USER"
  }
}

End-user experience: User will be prompted to link their external account via OAuth when they first start the workflow that contains this connector.

Developer experience: Developer does not have to implement authentication in the app.

Usage info​

First, import Connectors from deno-slack-hub into your project's import_map.json file, like this:

import_map.json
{
    "imports": {
      "deno-slack-hub/": "https://deno.land/x/deno_slack_hub@2.2.0/",
      "deno-slack-sdk/": "https://deno.land/x/deno_slack_sdk@2.14.2/",
      "deno-slack-api/": "https://deno.land/x/deno_slack_api@2.8.0/"
    }
  }

Next, import Connectors at the top of your workflow's definition file:

my_workflow_file.ts
import { Connectors } from "deno-slack-hub/mod.ts";

Finally, add the connector as a step in your workflow just like you would a Slack function.

my_workflow_file.ts
SomeWorkflow.addStep(
  Connectors.Asana.functions.CreateTask, {
  //...

🧙🏼 Your admin may need to approve the connector first. If your workspace has been configured to only allow admin-approved apps, the CLI will prompt you to send an admin approval request the first time you try to use a connector that hasn't been approved by an admin yet. While waiting for admin approval, the CLI may report an error like this:

Workflow function X is referring to an unknown step output parameter Y

You can safely ignore this error; it will go away as soon as your workspace admin approves your request to use the connector.