Atualizando um Lead

patch https://{subdomain}.kommo.com/api/v4/leads/{id}

Este método permite atualizar um único lead. Passe um objeto para atualizar um único lead.

Limitações
O método está disponível de acordo com os direitos do usuário.

Tipo de autorização
OAuth 2.0 com Token de Acesso / Token de Longa Duração

Cabeçalho de tipo de dado quando a solicitação é bem-sucedida
Content-Type: application/hal+json

Cabeçalho de tipo de dado em caso de erro
Content-Type: application/problem+json

Parâmetros de resposta
O método retorna uma coleção de leads criados.

Path Params

int32

required

ID do Lead

Body Params

name

string

Nome do Lead

price

int32

Venda do Lead

status_id

int32

ID da Etapa à qual o Lead foi adicionado, sendo a primeira etapa do pipeline principal a padrão

pipeline_id

int32

ID do Pipeline ao qual o Lead foi adicionado

created_by

string

O ID do usuário que cria o Lead. Ao passar o valor 0, o lead será considerado como criado pelo robô.

updated_by

int32

O ID do usuário que atualiza o Lead. Ao passar o valor 0, o lead será considerado como atualizado pelo robô.

created_at

int32

A data e hora em que o lead foi criado no formato de Unix Timestamp

updated_at

int32

A data e hora em que o lead foi atualizado no formato de Unix Timestamp

closed_at

int32

A data e hora em que o lead foi fechado no formato de Unix Timestamp

loss_reason_id

int32

ID da razão da perda

responsible_user_id

int32

ID do usuário responsável pelo Lead

custom_fields_values

json

Um array contendo informações sobre os valores dos campos personalizados especificados para este Lead

_embedded

object

Dados das tags adicionadas a um lead

request_id

string

Campo que será retornado inalterado na resposta e não será salvo.

tags_to_add

array of objects

Array de tags a serem adicionadas. Você precisa passar o nome ou o ID da tag.

tags_to_add

tags_to_delete

array of objects

Array de tags a serem deletadas. Você precisa passar o nome ou o ID da tag.

tags_to_delete

Responses

Language

Credentials

OAuth2

URL


xxxxxxxxxx
1
curl --request PATCH \
2
     --url https://subdomain.kommo.com/api/v4/leads/id \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400

401401

429429

500500