Saltar al contenido
Índice

Crear una tarea

POST/v1/crm/contacts/{id}/tasks

Al responsable del contacto o, si no tiene o no lo ve, al de la llave. Si ninguno puede verlo, 422.

Permiso de la llave:«Registrar llamadas y tareas» (activities_write)Permiso del rol:crm.edit

Cabeceras

  • Authorizationstringobligatorio

    Bearer y el secreto de la llave.

  • Idempotency-Keystring

    Recomendada. De 1 a 200 caracteres. La misma clave y la misma petición devuelven la misma respuesta durante 24 h, sin repetirla. Sin ella, un reintento se hace otra vez.

Parámetros de ruta

  • idstringobligatorio

    El contacto.

    uuid

Cuerpo

JSON, con Content-Type: application/json.

  • titlestringobligatorio

    Qué hay que hacer.

    hasta 200 caracteres

  • dueOnstring

    Para cuándo, un día.

    fecha (AAAA-MM-DD) · hasta 10 caracteres

  • notesstring

    Detalle.

    hasta 4000 caracteres

Respuestas

  • 201Creada.Ver campos
    • idstringobligatorio

      La tarea.

      uuid · hasta 36 caracteres

    • assigneeobject · puede ser nullobligatorio

      Quién la recibe: el responsable del contacto o, si no, el de la llave. Nulo si la llave no tiene «Ver contactos».

    • assignee.namestringobligatorio

      Nombre.

  • 400Algo no es válido: error.field dice qué.
  • 401Sin llave, o no vale.
  • 403Fuera del plan (code plan); la llave sin el permiso de su rol o sin el permiso de API de la operación (code forbidden); o desde una IP que la llave no permite (code ip_not_allowed).
  • 404No existe o no lo alcanza.
  • 409duplicate, conflict, idempotency_conflict o in_progress.
  • 413El cuerpo es demasiado grande.
  • 422Nadie que pueda verlo puede recibirla (no_assignee).
  • 429Más de 120 peticiones por minuto con la llave, o de 600 en la organización. Con Retry-After.
  • 503No se pudo atender. Con Retry-After: repítela.