API für Ihr CRM

Verbinden Sie Ihr CRM oder Reporting-Tools mit TixFlow und lesen Sie Ihre Veranstaltungen, Bestellungen, Gäste und Kunden.

Was die API bietet

Eine REST-API nur zum Lesen Ihrer eigenen Daten: Veranstaltungen, Bestellungen (mit ihren Tickets), Gäste (Tickets mit Gastnamen und Check-ins) und Kunden (alle, die bei Ihnen gekauft haben, ein Eintrag pro E-Mail-Adresse). Die vollständige Referenz finden Sie unter /developers/api.

Schlüssel erstellen

Portal → Einstellungen → Integrationen → API-Schlüssel → Schlüssel erstellen.

Geben Sie dem Schlüssel einen Namen (z. B. „HubSpot-Sync“) und wählen Sie, was er lesen darf.
Bestätigen Sie, dass Ihre Organisation Verantwortlicher für die exportierten Käuferdaten ist.
Kopieren Sie den Schlüssel sofort – er wird nur einmal angezeigt. Wenn Sie ihn verlieren, widerrufen Sie ihn und erstellen einen neuen.

Nur der Inhaber des Veranstalterprofils kann Schlüssel erstellen und widerrufen. Ein Schlüssel liest nur die Daten des Veranstalters, für den er erstellt wurde.

Die API aufrufen

Senden Sie den Schlüssel im Header Authorization:

curl https://tixflow.org/api/v1/orders?createdFrom=2026-10-01T00:00:00Z \
  -H "Authorization: Bearer tf_live_…"

Listen liefern data, nextCursor und hasMore. Solange hasMore true ist, rufen Sie erneut mit cursor=<nextCursor> auf.

Ihr CRM aktuell halten

Sortieren Sie nach updatedAt und speichern Sie den letzten nextCursor. Beim nächsten Mal senden Sie ihn zurück und erhalten nur Änderungen – neue Bestellungen, Erstattungen, Check-ins.

# first run: everything, oldest change first
GET /api/v1/orders?sort=updatedAt
# store nextCursor; next run, only what changed since:
GET /api/v1/orders?sort=updatedAt&cursor=<stored nextCursor>

Derselbe Datensatz kann zweimal ankommen – aktualisieren Sie per id, statt neu anzulegen.
Änderungen der letzten Sekunden erscheinen beim nächsten Aufruf.
Löschungen werden nicht gemeldet.

Marketing-Einwilligung

Bei jedem Online-Kauf können Käufer ein freiwilliges Kästchen ankreuzen, um Neuigkeiten von Ihnen zu erhalten. Die API liefert die Antwort als marketingConsent: true, false oder null, wenn nie gefragt wurde (Verkauf vor Ort, ältere Bestellungen). Die API exportiert alle Käufer unabhängig davon – was die Antwort erlaubt, entscheiden Sie als Verantwortlicher.

Limits