Saltar al contenido principal
POST
Crear conversión de lead
Scopes requeridos: leads.write

Autorizaciones

Authorization
string
header
requerido

Usa Authorization: Bearer rk_live_....

Encabezados

Idempotency-Key
string
requerido

Un valor único para cada solicitud nueva, como un UUID. Envíe el mismo valor para reintentar una solicitud de forma segura. La misma clave y el mismo payload repiten la primera respuesta con Idempotency-Replayed: true.

Required string length: 1 - 160

Parámetros de ruta

lead_id
string
requerido

Cuerpo

application/json
external_event_id
string
requerido
Required string length: 1 - 200
session_id
string | null
visualization_id
string | null
conversion_url
string<uri> | null
entry
enum<string>

Entrada al sitio web de este punto de contacto de conversión. Se omite cuando no está definida.

Opciones disponibles:
button,
embed,
direct
contact_name
string | null
contact_email
string<email> | null
contact_phone
string | null

Teléfono solo de EE. UU. Valores inválidos o no estadounidenses devuelven VALIDATION_ERROR.

property_address
string | null

Dirección de propiedad opcional. Se aceptan vacío, país EE. UU. explícito o formatos de estado + ZIP de EE. UU.; valores claramente no estadounidenses devuelven VALIDATION_ERROR.

occurred_at
string<date-time>

Fecha/hora ISO 8601 con Z o un desfase ±HH:MM. Se almacena en UTC.

lead_type
string

Canal de este punto de contacto. Envíe la clave o la etiqueta actual de un tipo de lead del workspace. El valor predeterminado es external. Un valor desconocido devuelve VALIDATION_ERROR.

Required string length: 1 - 100
form_name
string | null

Nombre del formulario que envió este punto de contacto.

Maximum string length: 200
form_key
string | null

Identificador estable del formulario que envió este punto de contacto.

Maximum string length: 500

Respuesta

Conversión existente reproducida o devuelta por external_event_id.

conversion
object
requerido
created
boolean
requerido