La API detrás del panel de Gomry.

REST sobre HTTPS, claves API con permisos por recurso y notificaciones webhook para las actividades compatibles de Gomry.

Crea una integración que lea eventos o contactos, o cree registros con los permisos que concedas. Tu equipo desarrolla la conexión con la plataforma existente de Gomry; la API no es un servicio de desarrollo de sistemas de entradas por encargo.

Obtener claves API Leer la documentación

events.tswebhooks.ts

// List your events. Same endpoint the dashboard uses.
const res = await fetch(
  "https://www.gomry.com/api/v1/events?page=1&page_size=20",
  { headers: { "X-API-KEY": process.env.GOMRY_API_KEY } }
);
const { data, pagination } = await res.json();

// Attendees for the first event.
const attendees = await fetch(
  `https://www.gomry.com/api/v1/events/${data[0].id}/attendees`,
  { headers: { "X-API-KEY": process.env.GOMRY_API_KEY } }
).then(r => r.json());

Por qué importa

Una sola API, panel incluido.

La API cubre spaces, eventos, experiencias, recurrencias, clases de entrada, asistentes, contactos, listas, formularios, solicitudes, pagos y campos personalizados. Las claves se crean en Configuración de la organización → API Keys.

Autenticación y scopes

Claves API enviadas en la cabecera X-API-KEY. Cada clave lleva un mapa de scopes: none, read o write por recurso. Cualquier lenguaje sobre HTTPS.

Opciones de entrega de webhooks

Utiliza suscripciones webhook firmadas con reintentos para los eventos compatibles de registro y respuestas a formularios, o URL webhook heredadas de la organización con un payload y un comportamiento de entrega diferentes.

Paginación y límites

Los endpoints con listas paginadas devuelven información de las páginas. Consulta los límites de respuesta de cada endpoint; el límite es de 60 solicitudes cada 10 segundos por clave de API, con el mismo margen por dirección IP. Las respuestas incluyen cabeceras RateLimit, y un 429 incluye Retry-After.

Elige cómo reciben las actualizaciones tus sistemas.

Configura las notificaciones para la actividad de Gomry que necesita tu integración. La API de suscripciones webhook y las URL heredadas del panel tienen tipos de eventos, payloads y reglas de entrega diferentes.

Suscripciones webhook firmadas

Crea suscripciones mediante la API o deja que Zapier las cree para sus triggers instantáneos. Elige registros mediante checkout o eventos de respuestas a formularios, con un filtro por evento o formulario cuando esté disponible.

Los payloads incluyen un ID de evento estable. Las cabeceras de entrega contienen una firma HMAC-SHA256. Los tiempos de espera agotados, los errores de red y las respuestas 429 o 5xx activan reintentos con esperas crecientes. Las demás respuestas 4xx no. Los eventos pueden llegar más de una vez o fuera de orden.

URL webhook heredadas de la organización

Para integraciones existentes, añade URL HTTPS en Organization Settings → API Keys → Webhooks. Cada URL recibe los eventos heredados compatibles de la organización sobre pagos, suscripciones y formularios.

Esta vía utiliza payloads heredados sin firmas ni reintentos. Antes de actuar sobre datos de pago sensibles, tu receptor confirma el pago mediante la API.

Envía registros al CRM que ya utilizas

Para añadir a tu CRM asistentes que se registran mediante checkout, tu desarrollador proporciona un receptor HTTPS, verifica las firmas de las suscripciones y asigna los datos de los asistentes a los campos de la API del CRM. La integración debe gestionar entregas repetidas y definir qué registros crear o actualizar. Configurar un destino webhook no crea por sí solo una sincronización continua.

Configuración y entrega de webhooks

Referencia

Algunas de las llamadas que usarás.

Método	Endpoint	Función
GET	/api/v1/events	Lista tus eventos, con paginación.
POST	/api/v1/events	Crea un evento.
GET	/api/v1/events/:id/attendees	Asistentes de un evento, con el estado de la entrada.
GET	/api/v1/events/:id/ticket-classes	Tipos de entrada con precio y aforo.
GET	/api/v1/payments	Pagos de toda la organización.
POST	/api/v1/contacts	Crea un contacto.