Saltar al contenido principal
POST
Registrar envío de formulario
Scopes requeridos: analytics.manage

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

Cuerpo

application/json
external_event_id
string
requerido
Required string length: 1 - 200
session_id
string
requerido
Required string length: 1 - 500
page_url
string<uri> | null
referrer_url
string<uri> | null
user_agent
string | null
Maximum string length: 512
occurred_at
string<date-time>

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

submitted_at
string<date-time>

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

form_id
string | null
Maximum string length: 200
form_name
string | null
Maximum string length: 200
form_selector
string | null
Maximum string length: 500
contact_name
string | null
Maximum string length: 200
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.

Maximum string length: 500
form_data
object

Campos enviados arbitrarios. Un consentimiento rechazado elimina las claves de seguimiento conocidas de nivel superior. Los valores de texto libre no se analizan.

attribution_params
object
Opciones disponibles:
implicit,
required

Respuesta

Envío duplicado o replay idempotente devuelto.

event
object | null
requerido
duplicate
boolean
requerido
analytics_only
boolean
requerido
recorded_analytics
boolean
requerido
lead_id
string | null
requerido
created
boolean
requerido