API y webhooks
En servicioUna API de gestión de eventos con webhooks firmados.
Lee eventos, invitados, respuestas y registros de entrada, añade y actualiza invitados desde tus propios sistemas, y recibe un mensaje firmado en cuanto algo ocurre en el evento.
- API REST v1
- Trece eventos de webhook
- Professional y Agency
POST /winglark HTTP/1.1
Winglark-Signature: t=1762338012,v1=5f2b…c9e1
Winglark-Event: rsvp.submitted
Winglark-Delivery: 7c1e9a42-…
{
"type": "rsvp.submitted",
"created_at": "2026-11-05T18:40:12.481Z",
"event_id": "6f1c2a7e-…",
"data": {
"response": "yes",
"party_size": 2,
"guest": { "first_name": "Ada", "email": "a•••@example.com" }
}
}Los datos de contacto siguen enmascarados salvo que el punto de conexión pueda verlos.
Qué hace
Tus sistemas, al día gracias al propio evento.
Todo lo que sigue funciona hoy en los planes Professional y Agency.
- Leer el evento
- Eventos, invitados, respuestas y registros de entrada, paginados con cursor para que una lista grande llegue por partes.
- Escribir la lista
- Añade o actualiza invitados desde una web de entradas, un CRM o un formulario. Una clave de idempotencia hace inofensivo un reintento.
- Enterarse al momento
- Webhooks para respuestas, invitaciones, la puerta, entradas, plano de mesas y credenciales, firmados con marca de tiempo.
- Ver cada envío
- Un registro con cada estado e intento, reenvío, evento de prueba y pausa de las direcciones que fallan.
Cómo funciona
Tres pasos.
- Crea una claveEn Integraciones, elige sus permisos y, si quieres, una fecha de caducidad. Cópiala: se muestra una sola vez.
- Añade un punto de conexiónIndica la dirección HTTPS y los eventos que debe escuchar. Envía un evento de prueba para comprobar la firma.
- Construye encimaLlama a la API con la clave y actúa sobre cada webhook. La referencia para desarrolladores tiene cada ruta y campo.
En el producto
Claves, webhooks y cada envío, en una sola pantalla.
Las integraciones están en los ajustes del espacio de trabajo. Una clave se crea con los permisos que necesita y se muestra una vez; un punto de conexión recibe los eventos que debe escuchar; el registro de envíos muestra qué salió, qué volvió y qué se está reintentando.
Espacio de trabajo, claves y envíos de ejemplo. Las pantallas están dibujadas a partir del producto tal como funciona.
Qué necesitas
Un espacio de trabajo en el plan Professional o Agency, y alguien que pueda recibir una petición HTTPS. Free, Starter y Single Event no incluyen la API.
Abrir la referencia para desarrolladores →Integraciones →Comparar los planes →
Los eventos a los que puede suscribirse un punto de conexión
- guest.created
- guest.updated
- guest.archived
- rsvp.submitted
- invitation.sent
- invitation.delivered
- invitation.bounced
- checkin.admitted
- ticket.issued
- event.published
- event.cancelled
- seatmap.published
- badge.printed
Preguntas
¿Hay una API REST para listas de invitados de eventos?
Sí: lista, lee, crea y actualiza invitados por evento, y lee respuestas y registros de entrada. Las respuestas son JSON, las listas usan paginación por cursor y las creaciones aceptan una clave de idempotencia.
¿Cómo se firman los webhooks?
Con un HMAC sobre una marca de tiempo y el contenido sin procesar, enviado en la cabecera Winglark-Signature. Al rotar el secreto, el anterior sigue siendo válido durante un solapamiento, así que nada se pierde en el cambio.
¿Hay límites de peticiones?
Sí, por clave. Una petición por encima del límite recibe el estado 429 y puede repetirse tras la espera que indica la respuesta.
¿Puede limitarse una clave a solo lectura?
Sí. Una clave solo lleva los permisos con los que se creó — por ejemplo, leer eventos y respuestas, sin escribir nada.
Da una clave a tus sistemas.
En Professional y Agency, desde los ajustes del espacio de trabajo.