Pular para o conteúdo
Tarefas

Criar tarefa

v1.0.0
POSThttps://api.staging.growthaisystem.com/api/v1/tasks
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escoposcontacts.write

Tarefa de um contato e/ou de um negócio (contactId, opportunityId). #1236 (API-10): sem nenhum dos dois, a tarefa é INTERNA e pede assigneeUserId (membro ativo) e dueAt (ISO-8601 com fuso): ela entra na Agenda do responsável como lembrete, no horário do prazo, e não aparece na linha do tempo de nenhum contato. Para listar só as internas, GET /tasks?internal=true. Aceita Idempotency-Key.

Corpo da requisição

application/jsonobrigatório
  • titlestringobrigatório
    • tamanho 1–200
  • bodystring | nullopcional
    • tamanho máx. 10000
  • contactIdstring | nullopcional
  • opportunityIdstring | nullopcional
  • dueAtstring | nullopcional
  • assigneeUserIdstring | nullopcional

Respostas

11 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

201Deu certoapplication/json

Tarefa criada, com o id definitivo e os vínculos de contato/negócio já resolvidos. Repetir a Idempotency-Key também responde 201 (esta rota não sinaliza replay no corpo).

V1Task

  • idstring
  • contactIdstring | null
  • opportunityIdstring | null
  • titlestring
  • bodystring | null
  • dueAtstring | null
  • completedAtstring | null
  • assigneeUserIdstring | null
  • createdAtstring