API

La API detrás del panel de Gomry.

REST sobre HTTPS, claves API con scopes por recurso, webhooks para pagos, formularios y suscripciones.

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.

Webhooks

Cinco tipos de evento hoy: pago completado, respuesta a formulario creada y actualizada, suscripción creada y eliminada. La entrega es best-effort y sin firma: confirma con la API antes de actuar.

Paginación y límites

Listados paginados en cada colección. Los límites de frecuencia por clave están documentados.

Referencia

Algunas de las llamadas que usarás.

POST
Lista tus eventos, con paginación.
POST
Crea un evento.
GET
Asistentes de un evento, con el estado de la entrada.
POST
Clases de entrada con precio y aforo.
POST
Pagos de toda la organización.
Crea un contacto.
Crea una clave y haz la primera llamada.