April 30, 2026

Die Usetix-API: Bau auf deinem Account auf

Webhooks sind super, wenn etwas passiert. Die neue Usetix-API ist für die Momente, in denen du etwas passieren lassen willst.

Ab heute steht eine vollständige REST-API zur Verfügung. Du kannst alles in deinem Account lesen — Events, Tickets, Bestellungen, Kunden, Locations, Künstler — und das meiste davon anlegen oder ändern. Baue interne Dashboards, synchronisiere Kunden mit deinem CRM, automatisiere die Event-Einrichtung oder verbinde Ticketing-Daten mit allem, was du sonst betreibst.

So funktioniert’s in 30 Sekunden

Erstelle einen Token unter Einstellungen → API-Tokens im Admin-Dashboard. Wähle Lesen für Analytics und Exporte oder Lesen + Schreiben für Integrationen, die Daten in deinem Namen ändern. Dann richtest du einen beliebigen HTTP-Client auf dieselben URLs, die du im Browser besuchen würdest — bitte einfach JSON an:

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

Das war’s. Keine Account-ID in der URL. Kein /v1/-Präfix. Der Token trägt den Account-Bezug, und die URL ist dieselbe wie im Browser — Accept: application/json wechselt das Antwortformat.

Was in V1 enthalten ist

Lesen — vollständiger Zugriff auf:

Events (mit eingebetteten FAQs und benutzerdefinierten Checkout-Feldern)
Tickets (Standard und Gruppe)
Bestellungen (mit Positionen und Einlöse-Status)
Kunden (mit Bestellhistorie und Marketing-Einwilligung)
Locations
Künstler
Mitgliedschaften (dein Team)

Schreiben — anlegen, ändern oder löschen:

Events, inklusive Veröffentlichen / Offline nehmen
Standard- und Gruppen-Tickets, inklusive Archivieren / Wiederherstellen
Locations
Künstler (mit Rich-Text-Biografien und Bild-Uploads)
Event-FAQs
Benutzerdefinierte Checkout-Felder

Bild-Uploads richtig gemacht

Für Bilder und andere Dateien nutzt du den zweistufigen Direct-Upload-Flow von Active Storage:

POST mit den Metadaten deiner Datei an /rails/active_storage/direct_uploads. Du bekommst eine signed_id und eine vorsignierte Upload-URL zurück.
PUT der Datei-Bytes direkt an diese URL. Sie laufen nicht durch Usetix.
Referenziere die signed_id in deinem nächsten API-Aufruf ({"image": "<signed_id>"}).

Große Dateien blockieren unsere Server nicht. Kleine fühlen sich trotzdem sofort an. Derselbe Flow, den unser Admin-UI intern verwendet.

Versionslose URLs

Du wirst merken, dass kein /v1/ im Pfad steht. Wir folgen hier dem Basecamp-Ansatz: saubere URLs, kein Versions-Wildwuchs. Wenn Breaking Changes unvermeidbar sind — und wir tun alles, um sie zu vermeiden — werden Legacy-Endpunkte auf einen separaten Host umziehen, mit 3–6 Monaten Übergangsfrist. Du migrierst nach deinem Zeitplan, nicht nach unserem.

Was du damit bauen kannst

Die API plus Webhooks decken die meisten Integrationsmuster ab, die wir bisher gehört haben:

Eigene Dashboards — ziehe Events, Bestellungen und Umsätze in dein Analytics-Tool
CRM-Sync — wenn eine Bestellung reinkommt (per Webhook), reichere den Kontakt mit der vollen Kundenhistorie an (per API)
Automatisierte Event-Einrichtung — skripte das Anlegen wiederkehrender Events oder importiere aus einer anderen Plattform
Interne Admin-Tools — baue einen schlanken Client für den Workflow deines Teams, ohne auf uns warten zu müssen
Bulk-Edits — passe Ticketpreise, Kapazitäten oder Verkaufszeiträume bei vielen Events gleichzeitig an
Berichte für die Buchhaltung — hole Kundenrechnungen, bezahlte Bestellungen und Erstattungen in der Form, die dein Finanzsystem braucht

Jetzt ausprobieren

Die API ist für alle Usetix-Accounts verfügbar. Erstelle einen Token unter Einstellungen → API-Tokens in deinem Admin-Dashboard.

Die vollständige Dokumentation findest du auf usetix.io/docs/api — Authentifizierung, jeder Endpunkt, jedes Feld, mit curl-Beispielen.

Fragen oder Probleme? Schreib uns an [email protected]. Wir freuen uns zu hören, was du baust.