Create task
The Asana Create Task AI tool streamlines task management by allowing users to seamlessly create tasks within Asana projects, workspaces, or as subtasks with detailed context and assignment options. It supports rich HTML notes, direct mentions, and detailed scheduling features to enhance productivity and collaboration.
Features
- Create tasks with detailed names, descriptions, and HTML-based notes for rich content.
- Assign tasks to users with options for specifying workspace, project, or parent tasks.
- Set due dates and start dates with ISO 8601 format support for precise scheduling.
- Manage task types including milestones, approvals, sections, and default tasks.
- Support for custom fields, status options, followers, and approval workflows directly through API integration.
Benefits
- Enhances project management efficiency by automating task creation and assignment.
- Improves team collaboration with direct tagging and mentions within task descriptions.
- Ensures precise scheduling with flexible date and time fields.
- Supports complex project structures by enabling subtasks and custom task types.
- Facilitates better tracking and workflow with approval statuses and follower management.
Description
Create task in Asana with context. REQUIRES one of: project_id, parent, or workspace+assignee together. For assignee-only tasks, both workspace and assignee must be provided. Returns task ID with confirmation. You can directly tag and mention people by using links in html_notes field
Parameters
19 parameters
| Name | Type | Description |
|---|---|---|
| namerequired | string | Name of the task. |
| project_id | string | Project GID for task creation. Required if not using parent or workspace+assignee. |
| workspace | string | Workspace GID where task will be created. Required when using assignee without project_id. |
| parent | string | Parent task GID to create this as a subtask. |
| html_notes | string | Task description in HTML format. You can create links to other asana objects with the following instructions: For <a> tags specifically, to make it easier to create @-mentions through the API, we only require that you provide the GID of the object you wish to reference. If you have access to that object, the API will automatically generate the appropriate href and other attributes for you. For example, to create a link to a task with GID "123", you can send the tag <a data-asana-gid="123"/> which will then be expanded to <a href="https://app.asana.com/0/0/123/f" data-asana-accessible="true" data-asana-dynamic="true" data-asana-type="task" data-asana-gid="123">Task Name</a>. You can also generate a link to a task in a specific project or tag by including a data-asana-project or data-asana-tag attribute in the <a> tag. All other attributes, as well as the contents of the tag, are ignored. To keep the contents of your tag and make a custom vanity link, include the property data-asana-dynamic="false" when setting the contents of the tag. You would send <a data-asana-gid="123" data-asana-dynamic="false">This is some custom text!</a> and receive <a data-asana-accessible="true" data-asana-dynamic="false" data-asana-type="task" data-asana-gid="123">This is some custom text!</a> If you do not have access to the referenced object when you try to create a link, the API will not generate an href for you, but will instead look for an href you provide. This allows you to write back <a> tags unmodified even if you do not have access to the resource. If you do not have access to the referenced object and no href is provided, your request will be rejected with a 400 Bad Request error. Similarly, if you provide neither a GID nor a valid href, the request will be rejected with the same error. |
| notes | string | Task description and details. |
| assignee | string | User identifier for task assignment. Can be "me", an email, or a user GID. When used without project_id, workspace is also required. |
| due_on | string | Due date in ISO 8601 format (YYYY-MM-DD). |
| due_at | string | Due date and time in ISO 8601 format. |
| resource_subtype | enum | Task type (default_task, milestone, section, approval). |
| completed | boolean | True if the task is initially marked complete. |
| approval_status | enum | Approval status (pending, approved, rejected, changes_requested). |
| assignee_section | string | Section GID to place task in the assignee's My Tasks list. |
| followers | string | Comma-separated list of user identifiers. Can be "me", email addresses, or user GIDs. |
| start_on | string | Start date in ISO 8601 format (YYYY-MM-DD). |
| start_at | string | Start date and time in ISO 8601 format. |
| custom_fields | string | JSON string of custom fields in format: {"field_gid": "value"}. |
| custom_type | string | GID of a custom type to apply to the task. |
| custom_type_status_option | string | GID of a custom type status option to apply to the task. |
