November 12, 2025

API: Create Tasks With Subtasks

#What's New

  • Subtasks In A Single Call: Send subtasks: [] along with your task payload to create a parent task and its nested subtasks together.
  • Full Metadata Support: Preserve assignees, dates, tags, priority, custom properties, and markdown descriptions for both parent and subtasks.

#For Example

const res = await fetch('https://t0ggles.com/api/v1/tasks', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Authorization: 'Bearer YOUR_API_KEY',
},
body: JSON.stringify({
tasks: [
{
title: 'Launch Campaign Planning',
projectKey: 'MARKETING',
descriptionType: 'markdown',
descriptionContent: '## Launch Campaign Timeline ...',
// other task fields...
subtasks: [
{
title: 'Finalize creatives and copy',
projectKey: 'MARKETING',
descriptionType: 'markdown',
descriptionContent: '## Finalize creatives and copy ...',
// other task fields...
},
],
},
],
}),
});
console.log(await res.json()); // { success: true } or { error: true, message: '...' }

#Notes

  • projectKey must exist and the API key must have access to that board.
  • Subtasks inherit the same project by default (you can override with projectKey).