I’m sure API functionality to support custom task types may still be coming, but it seems somewhat deficient currently. From what I’ve worked through so far, the below functionality does not seem exist via API. If it does, and I simply can’t find it, I would be ever so grateful if it could be pointed out to me. Ability to create a custom task type (and attach to a project) Ability to copy an existing custom task type to another project And ideally, create a global custom task type that can be added to multiple projects I have however found that it is possible to convert an existing task to a custom task, but the documentation is somewhat lacking here and doesn’t describe the need to set the resource_subtype = custom before it will accept custom_type and custom_type_status_option values

Hi @Tristan_Blackburn , you may want to have a look at this thread: [image] [ Upcoming ] Further additions to the API regarding custom task types Changelog Summary This release builds upon the previously introduced “custom” resource_subtype for tasks, expanding the API to begin handling custom types and custom type statuses. The updates enable developers to view and modify the custom type and status of tasks, as well as retrieve all custom types for a given project. The two key fields that are being introduced on the task routes are: custom_type: The custom type associated with the task custom_type_status_option: The status option associated wit…

Thanks @Richard_Sather, certainly that covers the piece where the documentation is lacking re converting an existing task to a custom task - perhaps that should be updated in the docs at some point? There is no mention at this point about any future improvements however, specifically around the creation of a custom task type.

API for handling custom task types

Asana Community API & Developers

Richard_Sather 26 March 2025 22:31 2

Hi @Tristan_Blackburn , you may want to have a look at this thread:

Topic		Replies	Views
[ Upcoming ] Further additions to the API regarding custom task types Changelog tasks-api	27	1106	18 November 2025
Global Custom task types: the ability to add the same task type to multiple projects Features Launched launched , custom-task-types	16	808	30 October 2025
create_tasks and update_tasks don't support custom task types — request to extend API support API & Developers custom-fields , tasks	3	451	20 April 2026
Create task with resource_subtype = request API & Developers tasks	6	464	11 June 2026
Duplicate custom type tasks make custom type tasks. Ask the Community custom-task-types	4	155	13 March 2025

API for handling custom task types

Related topics