---
title: "Atualizar lead"
method: PUT
path: "/{alias}/leads/{id}"
tags: ["Leads"]
---

# Atualizar lead

`PUT /{alias}/leads/{id}`

Atualiza os detalhes de um lead específico

## Path parameters

- `alias` string, required
- `id` integer, required

## Request body

- LeadRequest — Representa os dados necessários para criar ou atualizar um lead
  - `name` string — O nome do lead
  - `email` string, email, required — O endereço de email do lead
  - `birthday` string, date — Data de nascimento do lead
  - `city` string — Cidade do lead
  - `state` string — Estado do lead
  - `genre` string — Gênero do lead
  - `params` object — Parâmetros adicionais
  - `utm_source` string — Origem da campanha UTM. O valor é sanitizado e normalizado automaticamente.
  - `utm_campaign` string — Nome da campanha UTM. O valor é sanitizado e normalizado automaticamente.
  - `utm_medium` string — Mídia da campanha UTM. O valor é sanitizado e normalizado automaticamente.
  - `utm_term` string — Termo da campanha UTM. O valor é sanitizado e normalizado automaticamente.
  - `utm_content` string — Conteúdo da campanha UTM. O valor é sanitizado e normalizado automaticamente.

## Response `200`

Lead atualizado com sucesso

- Lead — Representa um lead da lista de leads
  - `id` integer
  - `merchant_id` integer
  - `name` string
  - `email` string
  - `birthday` string, date
  - `city` string
  - `state` string
  - `genre` string
  - `utm_source` string
  - `utm_campaign` string
  - `utm_medium` string
  - `utm_term` string
  - `utm_content` string
  - `params` string
  - `is_customer` boolean
  - `customer_id` integer
  - `customer_since` string, date
  - `created_at` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.
  - `updated_at` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.

## Other responses

- `400` — Dados inválidos fornecidos
- `404` — Lead não encontrado
- `422` — Dados inválidos. Pode ocorrer quando campos obrigatórios estão ausentes, o formato é incorreto, ou quando o valor enviado resulta em uma string vazia após sanitização e normalização.

---

[API](https://skmtc.net/yampi/apis/yampi-api.md) · [All operations](https://skmtc.net/yampi/apis/yampi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yampi/yampi-api/versions/fa16c50bef09/schema)