Create a task

Create and publish a Quick Task for one or more users, with a title, optional description and due date.

POST https://cotlet.dev/api/v1/connecteam/tasks

write Confirm

Creates a single Quick Task like Add Task > Single Task > Publish Task. Connecteam requires a title and an assignee. With several assignees the task is done by them together as a team; set separate_tasks to create one task for each user instead. Assignees can read everything in the task, and it appears in their Quick Tasks. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: create_task
NameTypeDescription
title string required string Task title.
assignee_ids array required array User IDs from list_users.
description string string More detail for the assignees.
due_date date date Due date, YYYY-MM-DD.
separate_tasks boolean boolean true creates one task for each assignee. Default: false, one task for the team.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/connecteam/tasks \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"title","assignee_ids":"assignee ids"}'
Python
result = client.call("connecteam", "create_task", {"title":"title","assignee_ids":"assignee ids"})
Node.js
const result = await cotlet.call('connecteam', 'create_task', {"title":"title","assignee_ids":"assignee ids"});
CLI
cotlet call connecteam create_task --data '{"title":"title","assignee_ids":"assignee ids"}'

Example response

JSON

{
  "tasks": [
    {
      "task_id": 70331,
      "title": "Restock the walk-in cooler",
      "assignees": [
        "Marco Bell"
      ],
      "due_date": "2026-10-23",
      "status": "open"
    },
    {
      "task_id": 70332,
      "title": "Restock the walk-in cooler",
      "assignees": [
        "Ana Lopez"
      ],
      "due_date": "2026-10-23",
      "status": "open"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.