April 30, 2026

La API de Usetix: construye sobre tu cuenta

Los webhooks son geniales cuando algo ocurre. La nueva API de Usetix es para cuando quieres hacer que ocurra algo.

Hoy enviamos una API REST completa. Puedes leer todo en tu cuenta —eventos, entradas, pedidos, clientes, venues, performers— y crear o actualizar la mayor parte. Construye paneles internos, sincroniza clientes con tu CRM, automatiza la configuración de eventos o conecta datos de ticketing a cualquier otra cosa que operes.

Cómo funciona en 30 segundos

Genera un token desde Settings → API Tokens en tu panel de administración. Elige Read para analytics y exportaciones, o Read + Write para integraciones que cambien datos en tu nombre. Luego apunta cualquier cliente HTTP a las mismas URLs que visitarías en el navegador, solo pide JSON:

curl -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json" \
  https://app.usetix.io/admin/events

Eso es todo. Sin ID de cuenta en la URL. Sin prefijo /v1/. El token lleva la cuenta, y la URL es la misma que usa el navegador: Accept: application/json cambia la respuesta.

Qué hay en V1

Lectura: acceso completo a:

Eventos (con FAQs embebidas y campos personalizados de checkout)
Entradas (estándar y de grupo)
Pedidos (con líneas e estado de redención)
Clientes (con historial de pedidos y consentimiento de marketing)
Venues
Performers
Memberships (tu equipo)

Escritura: crear, actualizar o eliminar:

Eventos, incluyendo publish / unpublish
Entradas estándar y de grupo, incluyendo archive / unarchive
Venues
Performers (con bios en rich text y subida de imágenes)
FAQs del evento
Campos personalizados de checkout

Subida de imágenes bien hecha

Para imágenes y otros archivos, usa el flujo de subida directa en dos pasos de Active Storage:

POST de los metadatos del archivo a /rails/active_storage/direct_uploads. Recibes un signed_id y una URL de subida prefirmada.
PUT de los bytes del archivo directamente a esa URL. No pasan por Usetix.
Referencia el signed_id en tu siguiente llamada a la API ({"image": "<signed_id>"}).

Los archivos grandes no saturan nuestros servidores. Los pequeños siguen sintiéndose instantáneos. El mismo flujo que usa internamente nuestra UI de admin.

URLs sin versión

Notarás que no hay /v1/ en la ruta. Seguimos el enfoque de Basecamp: URLs limpias, sin proliferación de versiones. Cuando los breaking changes sean inevitables —y hacemos todo lo posible por evitarlos— los endpoints legacy se moverán a un host separado con una ventana de sunset de 3 a 6 meses. Migrás a tu ritmo, no al nuestro.

Qué puedes construir con ella

La API más webhooks cubre la mayoría de formas de integración que nos han contado:

Paneles personalizados: tira de eventos, pedidos e ingresos a tu propia herramienta de analytics
Sincronización de CRM: cuando llega un pedido (vía webhook), enriquece el contacto con el historial completo del cliente (vía API)
Setup automatizado de eventos: scripta la creación de eventos recurrentes o importa desde otra plataforma
Herramientas de admin internas: construye un cliente ligero a medida del flujo de tu equipo sin esperar a que enviemos la funcionalidad
Ediciones en lote: ajusta precios, capacidades o ventanas de venta en muchos eventos a la vez
Informes para tu contable: obtén facturas de cliente, pedidos pagados, reembolsos en la forma que necesite tu sistema financiero

Pruébalo ahora

La API está live en todas las cuentas Usetix. Genera un token en Settings → API Tokens en tu panel de administración.

La documentación completa está en usetix.io/docs/api EN only: auth, cada endpoint, cada campo, con ejemplos curl.

¿Dudas o bloqueado? Escríbenos a support@usetix.io. Nos encantaría saber qué construyes.