Saltar al contenido
Índice

Crear una tarea

POST/api/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:crm.read

Cabeceras

  • Authorizationstringobligatorio

    Bearer y el secreto de la llave.

  • Idempotency-Keystringobligatorio

    De 1 a 200 caracteres. La misma clave y la misma petición devuelven la misma respuesta durante 24 h, sin repetirla.

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

    • assigneeobjectobligatorio

      Quién la recibe: el responsable del contacto o, si no, el de la llave.

    • assignee.namestringobligatorio

      Nombre.

  • 400Algo no es válido: error.field dice qué.
  • 401Sin llave, o no vale.
  • 403Fuera del plan (code plan) o sin permiso (code forbidden).
  • 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 Retry-After.
  • 503No se pudo atender. Con Retry-After: repítela.