Sign in

v1

latestOpenAPI 3.1.02026-07-261630686.8 KB

Actualización de un lead

Este método permite actualizar un solo lead. Pasa un objeto para actualizar un único lead.

patch/api/v4/leads/{id}

Path parameters

idinteger required

ID del lead

Headers

Content-Typestring

Request body

namestring

Nombre del lead

pricenumber

Venta del lead

pipeline_idinteger

ID del pipeline al que se añade el lead

created_byinteger

El ID del usuario que crea el lead. Al pasar el valor 0, el lead será considerado como creado por el robot

updated_byinteger

El ID del usuario que actualiza el lead. Al pasar el valor 0, el lead será considerado como creado por el robot

created_atinteger

Fecha de creación del lead en formato de Unix Timestamp

updated_atinteger

Fecha de actualización del lead en formato de Unix Timestamp

closed_atinteger

Fecha de cierre del lead en formato de Unix Timestamp

loss_reason_idinteger

ID del motivo de pérdida del lead

responsible_user_idinteger

ID del usuario responsable del lead

custom_fields_valuesstring json

Un arreglo de los valores actuales de los campos personalizados del lead

request_idstring

Campo que se retornará sin cambios en la respuesta y que no se guardará

Response

200

Example response

{
  "_links": {
    "self": {
      "href": "https://devteam.kommo.com/api/v4/leads"
    }
  },
  "_embedded": {
    "leads": [
      {
        "id": 152464,
        "updated_at": 1686732474,
        "_links": {
          "self": {
            "href": "https://devteam.kommo.com/api/v4/leads/152464"
          }
        }
      }
    ]
  }
}