Saltar al contenido principal
POST
Envía un webhook de prueba

Autorizaciones

Authorization
string
header
requerido

Tu llave de API, enviada como Authorization: Bearer <key>. Las llaves reales y de prueba son distintas; la llave que envías decide en qué modo actúa la llamada. Para probar llamadas, usa una llave de prueba (empieza con lst_test_): no se envía ningún repartidor real y no se mueve dinero real, pero los webhooks se disparan y el dropoff.phone que des puede recibir mensajes de WhatsApp, así que usa tu propio número. Una llave real (empieza con lst_live_) reserva y cobra envíos reales.

Cuerpo

application/json

De qué evento enviar una muestra.

type
enum<string>
requerido

El tipo de evento publicado del que enviar una muestra.

Opciones disponibles:
delivery.status_changed,
delivery.updated,
delivery.courier_location,
withdrawal.updated,
store.updated,
store.connected

Respuesta

Aceptado. El evento de prueba es el que recibe tu endpoint, con test: true incluido (el campo test del evento). El envío queda en cola y ocurre justo después de esta respuesta; su resultado es un nuevo intento en GET /v1/webhook_deliveries.

Cada evento que recibe tu endpoint de webhook, y cada evento que devuelven las lecturas de depuración: uno de los seis de abajo, distinguidos por type. data es el objeto al que se refiere el evento, y su forma depende de type. Consulta WebhookEventEnvelope para los campos que todos comparten y para saber cómo se comporta la entrega (al menos una vez, sin orden).

id
string
requerido

El id del evento, con prefijo evt_. Deduplica por este.

Ejemplo:

"evt_9pQ2vX7mKdR4tYb1nZ3sLwCe"

created_at
string<date-time>
requerido

Cuándo se registró el evento, ISO-8601 en UTC.

Ejemplo:

"2026-07-28T18:41:03Z"

type
enum<string>
requerido

Qué evento es este.

Opciones disponibles:
delivery.status_changed
data
object
requerido

La forma de un envío: cada campo que puede llevar el objeto, con la nulabilidad que realmente tiene cada uno. Es la respuesta de cada operación que responde un envío (la creación, la consulta, una fila de lista, la reprogramación, la cancelación, el reintento y el reembolso) y el data de cada evento completo de envío, así que UN tipo sostiene todos ellos.

Cada operación devuelve el objeto completo. Un campo que una llamada dada todavía no puede tener está presente y es null en lugar de faltar: una respuesta de creación tiene courier en null, porque todavía no se asigna ningún repartidor, y una reprogramación solo responde con un pedido que sigue programado, así que su delivered_at es null.

El dinero va en centavos enteros, las marcas de tiempo son ISO-8601 en UTC, y cada enumeración de abajo es nuestra y no una copia de la de un tercero.

test
boolean

Presente, y en true, solo en un evento de prueba que pediste con POST /v1/test_webhooks. Un evento real no trae el campo en absoluto. El data de un evento de prueba es una muestra cuyos ids no corresponden a nada.

Ejemplo:

true