Eventtia API V3

Abierta por diseño, hecha para integrarse.

Cada operación del evento es un endpoint de la API. Registro, check-in, comunicaciones, matchmaking, analítica, pagos. Despliegues headless, webhooks en tiempo real, autenticación servidor a servidor. La API de eventos más completa de la industria, en producción en connect.eventtia.com.

Ver la documentación → Hablemos

POST /api/v3/m2m-auth

# Autentícate, obtén un token Bearer y empieza a integrar
curl https://connect.eventtia.com/api/v3/m2m-auth \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "<your_client_id>",
    "client_secret": "<your_client_secret>"
  }'

# Respuesta
{
  "access_token": "eyJhbGciOi...",
  "scope": "events:read events:write attendees:*",
  "expires_in": "2026-06-16T18:00:00Z",
  "token_type": "Bearer"
}

Integraciones activas en

Lo que se vuelve posible

Cuatro formas de integrar, todas abiertas.

Eventtia es infraestructura de eventos construida API-first. Los clientes operan dentro de sus propios sistemas, envían datos en tiempo real al resto de su stack, automatizan flujos de trabajo sobre la plataforma y, cada vez más, dejan que agentes de IA hagan las tres cosas.

01 / Headless

Incrusta Eventtia en tus propias superficies digitales.

Los participantes se registran dentro de tu sitio, tu app, tu checkout con tu marca, sin ver nunca a Eventtia. Todo el motor de registro vive detrás de la API. Nike integró Eventtia en Nike.com, la app de iOS y la app de Android en menos de 90 días, y hoy corre más de 5,000 eventos al año desde su propia infraestructura.

POST /api/v3/events/{event_id}/attendees

curl -X POST https://connect.eventtia.com/api/v3/events/12345/attendees \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "attendees",
      "attributes": {
        "email": "[email protected]",
        "first_name": "Maya",
        "last_name": "Khan",
        "attendee_type_id": 42
      }
    }
  }'

02 / Webhooks

Envía cada evento al resto de tu stack, en tiempo real.

Los webhooks a nivel de cuenta y de evento se disparan en el momento en que algo ocurre: se crea un participante, se confirma un pago, se imprime una credencial, se acepta una reunión. Puedes filtrar los webhooks de cuenta a áreas administrativas específicas. Tu CRM, tu data warehouse, tu dashboard de BI y tu automatización de marketing ven la misma fila al mismo tiempo.

POST /api/v3/account-webhooks

curl -X POST https://connect.eventtia.com/api/v3/account-webhooks \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "target_url": "https://hooks.yourcompany.com/eventtia",
    "trigger": "attendee_created",
    "administrative_area_ids": [3, 7]
  }'

03 / Flujos a medida

Construye las automatizaciones que la plataforma no trae de fábrica.

La API expone las operaciones granulares: aprobar un registro, actualizar asignaciones de talleres, marcar a un participante para imprimir su credencial, enviar una encuesta. Combínalas en los flujos que tu equipo de eventos realmente necesita. Los endpoints de lote offline cubren el caso de conectividad interrumpida en la puerta.

POST /api/v3/events/{event_id}/checkpoints/{checkpoint_id}/batch-checkin

# Check-in por lote de 200 participantes recolectados offline
curl -X POST "$URL/batch-checkin" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "checkpoints": [
      { "attendee_uuid": "abc-123", "checkpoint_id": 9,
        "action": "checkin", "action_at": "2026-05-22T09:14:11Z" },
      { "attendee_uuid": "def-456", "checkpoint_id": 9,
        "action": "checkin", "action_at": "2026-05-22T09:14:18Z" }
    ]
  }'

04 / Agentes de IA

Deja que los agentes de IA operen la plataforma de forma nativa.

El primer servidor abierto de Model Context Protocol para la gestión de eventos. Los agentes descubren lo disponible, llaman a los endpoints y orquestan flujos de trabajo sin integración a medida. Crear un evento, extraer estadísticas de registro, enviar un recordatorio segmentado: conversacional, no programático. Más detalle en la sección de MCP más abajo.

MCP mcp.eventtia.com

# En la configuración de tu agente (Claude, ChatGPT, uno a medida)
{
  "mcpServers": {
    "eventtia": {
      "url": "https://mcp.eventtia.com",
      "headers": {
        "Authorization": "Bearer $TOKEN"
      }
    }
  }
}

La cobertura de la API

Cada operación del evento, convertida en endpoint.

Más de 110 endpoints en toda la plataforma, agrupados como los piensa un integrador. Cada uno documentado en la referencia de la API con esquemas de solicitud y respuesta, modos de autenticación, comportamiento de caché y ejemplos de código.

Eventos

7 endpoints

POST /events
GET /events
GET /events/{id}
PATCH /events/{id}
GET /events/{id}/ticket-stats
GET /events/{id}/workshops-stats
GET /accounts/{uuid}/events

Participantes

13 endpoints

POST /events/{id}/attendees
GET /events/{id}/attendees
GET /attendees/{id}
PATCH /attendees/{id}
POST /attendees/{id}/cancel
POST /attendees/{id}/print
… búsqueda por correo, archivo, actualizaciones de talleres

Check-in y checkpoints

7 endpoints

POST /attendees/{id}/check-in
POST /checkpoints/{id}/check-in
POST /checkpoints/{id}/check-out
POST /batch-checkin
GET /checkpoints/{id}/check-ins
… aforo, tipos permitidos, sincronización offline

Conferencias de negocios matchmaking

25+ endpoints

GET /events/{id}/business-conferences
POST /meeting-requests
PATCH /meeting-requests/{id}/approve
GET /participants/{id}/agenda
GET /meetings/{id}/ics
… calificaciones, listas negras, horarios no disponibles, exportación ICS

Talleres y ponentes

22 endpoints

POST /workshops
POST /workshop-definitions
POST /attendees/{id}/workshops
GET /events/{id}/available-slots
… ponentes, categorías, definiciones, exportaciones

Pagos y complementos

7 endpoints

GET /events/{id}/purchase-items
GET /coupons/{id}
POST /coupons/{id}/validate
GET /attendees/{id}/purchase-items
… niveles de precio, cupones de descuento, complementos por participante

Engagement Q&A · encuestas

7 endpoints

GET /events/{id}/qa-sessions
POST /qa-sessions/{id}/questions
POST /qa-questions/{id}/like
GET /surveys/{id}
POST /surveys/{id}/answers

Webhooks

6 endpoints

POST /account-webhooks
POST /events/{id}/event-webhooks
GET /account-webhooks
DELETE /account-webhooks
… por disparador, filtrados por área, idempotentes

Usuarios, roles y permisos

6 endpoints

POST /users
GET /users
GET /users/{id}/permissions
GET /roles
… SSO, archivo, permisos granulares

Patrocinadores

3 endpoints

GET /events/{id}/sponsors
GET /sponsors/{id}
PATCH /sponsors/{id}

Geografía y datos de referencia

6 endpoints

GET /countries
GET /regions
GET /cities
GET /timezones
… cacheados 15 días, públicos

Autenticación

3 modos

POST /m2m-auth servidor a servidor
POST /authenticate usuario de backoffice
Tokens de participante apps de cara al participante

Ver cada endpoint en la referencia →

Autenticación

Tres modos de autenticación, uno por tipo de integración.

Backends servidor a servidor, acciones de usuarios de backoffice y apps de cara al participante reciben cada uno su propio tipo de token. JWT en toda la API. Los tokens llevan alcances y vencimientos, y la API los aplica a nivel de endpoint.

01 / Máquina a máquina

Credenciales de cliente OAuth.

Para integraciones de backend: sincronización con tu CRM, pipelines de data warehouse, tareas programadas. Cambias un client_id y un client_secret por un JWT, y lo envías como Authorization: Bearer .... Los alcances determinan a qué endpoints puedes llegar.

POST /api/v3/m2m-auth

02 / Usuario de backoffice

JWT de usuario.

Para herramientas que actúan en nombre de un usuario de Eventtia: scripts de administración, extensiones a medida del backoffice. Te autenticas con correo y contraseña (o SSO), y obtienes un JWT acotado al rol y a los permisos de ese usuario. Acceso granular vía el sistema de permisos.

POST /api/v3/authenticate

03 / Participante

Token de participante.

Para apps de cara al participante: el participante registrado navega su agenda, envía solicitudes de reunión, responde una encuesta, califica una sesión. El token está acotado al registro del propio participante; hay delegación para patrocinadores cuando uno gestiona a varios participantes.

Emitido durante el flujo de registro

Ejemplos de código

De la autenticación al webhook en veinte líneas.

Cinco operaciones comunes. Endpoints reales. Copia, pega, reemplaza el token, y funciona. La referencia completa incluye variantes en JS/TS, Python, Ruby y Go.

# 1. Autentícate como integración del lado del servidor
curl -X POST https://connect.eventtia.com/api/v3/m2m-auth \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "$CLIENT_ID",
    "client_secret": "$CLIENT_SECRET"
  }'

# Respuesta: el JWT para usar como token Bearer en cada otra llamada
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "scope": "events:* attendees:* checkpoints:* webhooks:*",
  "expires_in": "2026-06-16T18:00:00Z",
  "token_type": "Bearer"
}

# 2. Crea un evento dentro de tu cuenta
curl -X POST https://connect.eventtia.com/api/v3/events \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "events",
      "attributes": {
        "name": "ICORI 2026",
        "event_uri": "icori-2026",
        "start_date": "2026-05-22T09:00:00",
        "end_date": "2026-05-22T18:00:00",
        "timezone": "America/Bogota"
      }
    }
  }'

# 3. Registra un participante, opcionalmente con campos personalizados
curl -X POST https://connect.eventtia.com/api/v3/events/12345/attendees \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "attendees",
      "attributes": {
        "email": "[email protected]",
        "first_name": "Maya",
        "last_name": "Khan",
        "attendee_type_id": 42,
        "custom_fields": {
          "company": "Atlas Research",
          "dietary_restrictions": "vegetarian"
        }
      }
    }
  }'

# 4. Suscríbete a los eventos attendee_created a nivel de cuenta
# Opcionalmente, filtra a áreas administrativas específicas (regiones/marcas)
curl -X POST https://connect.eventtia.com/api/v3/account-webhooks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://hooks.yourcompany.com/eventtia",
    "trigger": "attendee_created",
    "administrative_area_ids": [3, 7]
  }'

# Tu endpoint recibe, por cada registro:
# { "event_id": 12345, "attendee_id": 98765, "occurred_at": "..." }

# 5. Haz check-in de un participante en un checkpoint específico
curl -X POST https://connect.eventtia.com/api/v3/checkpoints/9/check-in \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "attendee_uuid": "8c5e2-..."
  }'

# Para offline / por lote:
# POST /api/v3/checkpoints/9/batch-checkin
# con un arreglo de { attendee_uuid, checkpoint_id, action, action_at }

Webhooks

Datos en tiempo real, listos desde el primer día.

Los webhooks se disparan en el momento en que algo ocurre en la plataforma. Puedes suscribirte a nivel de cuenta (cada evento de la cuenta) o por evento. Las suscripciones de cuenta pueden filtrarse a áreas administrativas específicas. El endpoint recibe un payload en JSON con el ID de la entidad y la marca de tiempo del suceso; extrae el registro completo vía la API REST cuando lo necesites.

Disparadores disponibles

attendee_created llega un nuevo registro
attendee_updated cambia el perfil o el estado
attendee_paid se confirma un pago
attendee_checked_in el escaneo en la puerta funcionó
meeting_request_created se envía una solicitud de networking
meeting_accepted se aprueba una solicitud de networking
workshop_registration_created inscripción a una sesión
survey_answered se envía una respuesta

Lista completa de disparadores y esquemas de payload por disparador en la referencia de la API.

Dos alcances

A nivel de cuenta

Una sola suscripción que se dispara para cada evento de la cuenta que coincida con el disparador. El filtro opcional administrative_area_ids lo restringe a regiones, marcas o unidades de negocio específicas.

POST /api/v3/account-webhooks

A nivel de evento

Suscripción acotada a un solo evento. Útil para eventos de alta cardinalidad o integraciones puntuales. Requiere que el evento tenga los webhooks activados en su configuración.

POST /api/v3/events/{event_id}/event-webhooks

Para agentes de IA

El primer servidor MCP abierto para la gestión de eventos.

Model Context Protocol es el estándar emergente para que los agentes de IA descubran y llamen herramientas. Eventtia expone la plataforma como un servidor MCP, así que Claude, ChatGPT, agentes a medida y lo que venga después pueden operar eventos de forma nativa: crear un evento, extraer estadísticas de registro, enviar un recordatorio segmentado, orquestar flujos de trabajo, sin trabajo de integración a medida para cada modelo.

Un solo protocolo, cualquier agente. Los agentes descubren las herramientas disponibles igual que descubren Slack, GitHub o cualquier otro servidor MCP. Tus clientes no escriben adaptadores por modelo.

Conversacional, no programático. "Crea un taller para 200 personas el 12 de junio, invita a los participantes del evento de mayo y recuérdaselo a quien no haya respondido el jueves." El agente traduce eso a las llamadas correctas de la API.

La misma autenticación, el mismo modelo de datos. El servidor MCP se apoya sobre la API REST. Los mismos tokens, los mismos alcances, los mismos permisos. Lo que un agente puede hacer es exactamente lo que puede hacer un usuario humano con ese mismo token.

Más sobre el enfoque agéntico en el artículo del blog sobre software agéntico para eventos. Una página dedicada a MCP está en camino: llega pronto.

En producción

Nike opera más de 5.000 eventos al año sobre la API de Eventtia.

Infraestructura headless en Nike.com, la app de iOS y la app de Android.

El equipo global de TI de Nike integró Eventtia como infraestructura de eventos en tres superficies digitales. Los participantes se registran dentro de superficies con la marca Nike y nunca ven a Eventtia. El motor de registro, el flujo de pago, el historial de check-in, el reporting: todo detrás de la API, todo bajo la marca de Nike. La integración se completó en menos de 90 días. Hoy corre más de 5,000 eventos al año en todo el programa.

5,000+ eventos al año

3 superficies digitales

< 90 días hasta el arranque de la integración

Leer el caso de éxito de Nike →

Para desarrolladores

Documentación, entornos, soporte: sin cajas negras.

Referencia

Documentación completa de la API.

Cada endpoint con esquemas de solicitud y respuesta, ejemplos reales en varios lenguajes, prueba en vivo dentro de la página (vía ReadMe). Especificación OpenAPI disponible para generar clientes.

docs-connect-api-v3.eventtia.com →

Lista para LLM

Indexada para agentes de IA.

La documentación incluye un índice llms.txt en Markdown, más definiciones OpenAPI por endpoint. Los agentes pueden descubrir toda la cobertura de forma programática y llamar a los endpoints con contexto estructurado.

Ver llms.txt →

Soporte

Un equipo dedicado a integraciones enterprise.

Para despliegues headless al estilo Nike y configuraciones complejas multirregión, un ingeniero de integración de Eventtia se suma al proyecto desde la revisión de arquitectura hasta el lanzamiento. No es una cola de tickets.

Hablemos →

Estado

Estado de la plataforma en tiempo real.

Tiempo de actividad de la API, historial de incidentes y salud por componente en status.eventtia.com. Suscríbete por correo o RSS para recibir notificaciones de incidentes.

status.eventtia.com →

FAQ

Lo que siempre preguntan los responsables de integración.

¿Cuál es el SLA de disponibilidad de la API?

La disponibilidad de la API sigue el mismo SLA que la plataforma en general. Los incidentes de alta prioridad (caída total o cualquier cosa que bloquee un evento en vivo) tienen una meta de respuesta de 15 minutos y de resolución de 1 hora. El estado en vivo y el historial de incidentes están en status.eventtia.com; el SLA completo está en la página del SLA.

¿Cómo se versiona la API?

Se versiona en la URL. La versión de producción actual es /api/v3/. Los cambios incompatibles quedan detrás de una nueva versión; la anterior sigue disponible con plazos de descontinuación documentados. Las adiciones que no rompen nada (nuevos endpoints, nuevos campos opcionales) se lanzan dentro de la versión actual sin aviso previo.

¿Hay límites de tasa?

Sí, aplicados por token. El nivel por defecto cubre con holgura las cargas típicas de integración; las integraciones enterprise (a la escala de Nike, más de 5,000 eventos al año) reciben límites más altos como parte del despliegue. Las respuestas de límite de tasa incluyen los encabezados estándar X-RateLimit-Remaining y Retry-After, con lo que tu lógica de reintentos necesita.

¿Dónde está alojada la API?

Eventtia opera entidades legales en Europa con infraestructura tanto en la UE como en Estados Unidos. La misma API, las mismas funcionalidades, del lado del Atlántico que corresponda a tus exigencias de cumplimiento. La residencia de datos se elige a nivel de cuenta durante la implementación. El manejo alineado con el RGPD aplica en ambas regiones.

¿Qué autenticación usa la API?

JWT en toda la API. Tres tipos de token: máquina a máquina (credenciales de cliente OAuth, para integraciones del lado del servidor), usuario (para herramientas que actúan en nombre de un usuario de Eventtia) y participante (para apps de cara al participante). Los tokens llevan alcances y vencimientos, y la API los aplica a nivel de endpoint. Consulta la sección de autenticación más arriba para el modelo completo.

¿Los webhooks tienen firma de payload?

Sí. Cada entrega de webhook incluye una firma HMAC en los encabezados de la solicitud, calculada con un secreto compartido. Verifica la firma del lado del servidor antes de confiar en el payload. La protección contra reenvíos se da mediante una marca de tiempo del suceso más un nonce firmado.

¿Podemos probar en un sandbox antes de salir a producción?

Sí. Las integraciones enterprise reciben un entorno de prueba dedicado con una copia del modelo de datos de producción y la misma cobertura de la API. Útil para pruebas de integración en CI, migraciones de esquema y simulacros de cambios de despliegue antes de que toquen eventos reales.

¿Hay una colección de Postman o un SDK?

La especificación OpenAPI se publica junto con la documentación, lo que te permite generar clientes en cualquier lenguaje con herramientas estándar (openapi-generator, entre otras). Hay una colección de Postman disponible a solicitud. No enviamos SDKs propios por defecto, porque la mayoría de los equipos de integración prefiere generar el cliente que coincide con su propio código base.

¿Cómo se relaciona el servidor MCP con la API REST?

El servidor MCP se apoya sobre la API REST como una capa de traducción. Expone las operaciones de la API a los agentes de IA en el formato de Model Context Protocol. El modelo de autenticación es el mismo (tokens Bearer); los permisos son los mismos (lo que un agente puede hacer es exactamente lo que puede hacer vía REST un usuario con ese token). Más detalle en la sección de MCP más arriba; una página dedicada está en camino.

¿Quién es dueño de los datos a los que se accede vía la API?

Tú. Eventtia es el encargado del tratamiento de datos; tú eres el responsable. La API no añade ningún término de uso compartido o retención de datos más allá de lo que ya está en el contrato principal. Puedes exportar en cualquier momento, vía la API, los datos completos de participantes, transacciones y registro. La base legal está en la política de privacidad.

Construye con la API. Habla con un ingeniero de verdad.

Para despliegues headless a la escala de Nike y configuraciones complejas multirregión, un ingeniero de integración de Eventtia se suma a tu equipo desde la revisión de arquitectura hasta el lanzamiento. Treinta minutos, sin presentación, respuestas reales a preguntas reales.

Ver la documentación → Hablemos