Criar tarefa no Todoist, por uma API

Cria uma tarefa e a devolve. Sem project_id a tarefa vai para a Inbox. Defina o prazo com due_string, due_date ou due_datetime.

Identificador
todoist_create_task

A chamada

POST https://connect.reportei.com/api/tools/todoist_create_task/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "content": "<content>"
  }
}

Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.

Parâmetros

As descrições dos parâmetros seguem a documentação oficial do app, em inglês.

ParâmetroTipoObrigatórioDescrição
contentstringSimTitle of the task.
descriptionstringNãoDescription of the task.
project_idstringNãoId of the project, from List projects. Omit it to add the task to the Inbox.
section_idstringNãoId of a section of the project: the section_id of a task from List tasks.
parent_idstringNãoId of a task from List tasks, to create this one as its sub-task.
labelsarrayNãoLabel names of the task.
priorityintegerNãoFrom 1, normal, to 4, urgent. The app shows 4 as p1 and 1 as p4.
due_stringstringNãoDue date in natural language, for example tomorrow at 10am or every monday. Recurring dates are set this way.
due_datestringNãoAll-day due date, YYYY-MM-DD.
due_datetimestringNãoDue date and time in RFC 3339, for example 2026-02-12T12:00:00Z.
due_langstringNãoLanguage of due_string when it is not English, for example pt.
assignee_idintegerNãoId of a collaborator of the shared project to assign the task to, from List project collaborators, sent as a number.
durationintegerNãoDuration of the task in duration_unit. Only used together with duration_unit.
duration_unitstringNãoUnit of duration.Valores: minute, day
deadline_datestringNãoDeadline of the task, YYYY-MM-DD.

Conexões possíveis

O seu cliente conecta a conta do Todoist uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.

Chave de API

O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.

OAuth com o app do seu produto

Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/todoist, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.

A resposta

Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.

Pronta para agentes de IA

O input desta tool é um JSON Schema, disponível em GET /api/tools/todoist_create_task. Ele vira a definição de tool do seu agente sem conversão.

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.