curl --request PATCH \
  --url https://api.superlead.app/v1/leads/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "joao@empresa.com",
  "document": "123.456.789-01",
  "cep": "01310-100",
  "address": "Av. Paulista",
  "address_number": "1000",
  "city": "São Paulo",
  "state": "SP",
  "country": "BR"
}
'

{
  "id": "lead_0b5f8a3e-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
  "name": "João Silva",
  "phone": "+5511999999999",
  "source": "Meta Ads",
  "channel": "WhatsApp",
  "entry_point": "ctwa",
  "funnel_stage": "1º Contato",
  "document": "123.456.789-01",
  "document_type": "cpf",
  "cep": "01310-100",
  "address": "Av. Paulista",
  "address_number": "1000",
  "address_complement": null,
  "neighborhood": "Bela Vista",
  "city": "São Paulo",
  "state": "SP",
  "country": "BR",
  "created_at": "2026-06-01T12:00:00.000Z"
}

{
  "error": {
    "code": "invalid_request",
    "message": "The request body is invalid.",
    "request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1",
    "details": [
      {
        "path": "to",
        "message": "Required"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Missing or invalid API key. Send it as 'Authorization: Bearer sk_...'.",
    "request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
  }
}

{
  "error": {
    "code": "lead_not_found",
    "message": "No lead matches this recipient in your company. The API only messages existing leads.",
    "request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
  }
}

Leads

Editar Lead

Atualiza dados cadastrais de um lead — update parcial: envie só o que mudou. Campo omitido permanece como está; null explícito limpa o campo (nos campos anuláveis).

Telefone e etapa do funil não são editáveis por aqui. O telefone é a identidade WhatsApp do lead; a etapa muda por PUT /v1/leads/{id}/stage, que registra o histórico da transição.
document aceita CPF ou CNPJ. Enviando só document, o document_type é inferido pelo tamanho.

Retorna o cadastro completo já atualizado.

PATCH

leads

{id}

curl --request PATCH \
  --url https://api.superlead.app/v1/leads/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "joao@empresa.com",
  "document": "123.456.789-01",
  "cep": "01310-100",
  "address": "Av. Paulista",
  "address_number": "1000",
  "city": "São Paulo",
  "state": "SP",
  "country": "BR"
}
'

{
  "id": "lead_0b5f8a3e-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
  "name": "João Silva",
  "phone": "+5511999999999",
  "source": "Meta Ads",
  "channel": "WhatsApp",
  "entry_point": "ctwa",
  "funnel_stage": "1º Contato",
  "document": "123.456.789-01",
  "document_type": "cpf",
  "cep": "01310-100",
  "address": "Av. Paulista",
  "address_number": "1000",
  "address_complement": null,
  "neighborhood": "Bela Vista",
  "city": "São Paulo",
  "state": "SP",
  "country": "BR",
  "created_at": "2026-06-01T12:00:00.000Z"
}

{
  "error": {
    "code": "invalid_request",
    "message": "The request body is invalid.",
    "request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1",
    "details": [
      {
        "path": "to",
        "message": "Required"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Missing or invalid API key. Send it as 'Authorization: Bearer sk_...'.",
    "request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
  }
}

{
  "error": {
    "code": "lead_not_found",
    "message": "No lead matches this recipient in your company. The API only messages existing leads.",
    "request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
  }
}

Authorizations

Authorization

string

header

required

Chave de API da sua empresa (sk_...). Crie no painel Superlead em Integrações → API e envie em toda chamada como Authorization: Bearer sk_.... Veja Autenticação.

Path Parameters

string

required

Id do lead (lead_...), retornado por POST /v1/leads, GET /v1/leads?phone=... ou GET /v1/leads/{id}.

Body

application/json

name

string

Nome do lead, até 200 caracteres. Não aceita null.

Required string length: 1 - 200

Example:

"João Silva"

string<email> | null

E-mail do lead. Envie null para limpar.

Example:

"joao@empresa.com"

notes

string | null

Observações livres, até 2000 caracteres. Envie null para limpar.

Maximum string length: 2000

source

string

Origem do lead exibida no painel. Não aceita null.

Required string length: 1 - 120

Example:

"Indicação"

channel

string | null

Canal de origem. Envie null para limpar.

Required string length: 1 - 120

Example:

"WhatsApp"

entry_point

string | null

Ponto de entrada da conversão. Envie null para limpar.

Required string length: 1 - 120

utm_source

string | null

Atribuição: origem da campanha. Envie null para limpar.