Billetto API-Dokumentation und Webhooks-Guide
Was Sie mit der Billetto API bauen können
Die Billetto API ist eine REST API, die JSON zurückgibt. Sie gibt Ihrem eigenen Code Zugriff auf dieselben Daten, mit denen Ihr Ticketverkauf läuft: Events, Tickettypen, Bestellungen, Teilnehmer, Buchungseinträge, Buchungsfragen und Zielgruppen. Webhooks senden Ihnen Änderungen, sobald sie passieren, sodass Sie nicht danach fragen müssen.
Teams nutzen sie, um Käufer in ein CRM zu synchronisieren, Verkäufe in ein Data Warehouse zu laden, Events auf der eigenen Website anzuzeigen, Mitglieder zu Presale-Zielgruppen hinzuzufügen und Auszahlungen im Finanzsystem abzugleichen. Diese Seite erklärt, wie die API aufgebaut ist und wie Webhooks funktionieren. Das vollständige Schema jedes Endpunkts finden Sie in der API-Referenz.
Hier starten
- Einstiegs-Guide: Zugangsdaten erstellen und den ersten Aufruf senden
- API-Referenz: alle Endpunkte, Parameter und Antwortobjekte
- Webhook-Referenz: die Webhook-Ressource und ihre Felder
- Public Event Search: öffentlich verfügbare Events auf Billetto abrufen
Mit API-Schlüsselpaar oder OAuth 2.0 authentifizieren
API-Schlüsselpaare für Ihr eigenes Konto
Nutzen Sie ein Schlüsselpaar, wenn Ihre eigenen Systeme die API im Namen Ihres Veranstalterkontos aufrufen. Erstellen Sie es in Billetto unter Integrations → Developers → API - Key pairs, geben Sie ihm einen Namen, der den Zweck beschreibt (zum Beispiel „CRM-Sync“ oder „Data Warehouse“), und senden Sie es bei jedem Aufruf im Header Api-Keypair mit.
- Legen Sie pro System ein eigenes Schlüsselpaar an, damit Sie eines widerrufen können, ohne die anderen zu beeinträchtigen
- Bewahren Sie das Secret auf Ihrem Server auf. Liefern Sie es nie in einem Browser, einer mobilen App oder einem öffentlichen Repository aus
- Widerrufen und ersetzen Sie ein Schlüsselpaar sofort, wenn Sie vermuten, dass es öffentlich geworden ist
OAuth 2.0 für Apps, die andere Veranstalter nutzen
Nutzen Sie OAuth, wenn Sie ein Produkt entwickeln, mit dem sich andere Billetto-Veranstalter verbinden, zum Beispiel ein Marketing-Tool, eine Event-Plattform oder ein Agentur-Dashboard. OAuth verwendet den Authorization-Code-Flow: Der Veranstalter meldet sich bei Billetto an, genehmigt Ihre App und Sie erhalten ein Token für sein Konto. Sie sehen nie sein Passwort, und er kann Ihre App jederzeit trennen.
Beide Methoden werden Schritt für Schritt im Einstiegs-Guide beschrieben.
- Events
- Bestellungen und Teilnehmer
- Finanzen und Berichte
- Audiences
- Webhooks
- Öffentliche Events
Events und Tickettypen
Rufen Sie die Events Ihres Kontos mit Datum, Veranstaltungsort, Status und Tickettypen ab.
GET /organiser/eventslistet Ihre Events- Tickettypen, Preise und Verfügbarkeit pro Event
- Buchungsfragen, die Sie Käufern im Checkout stellen
Typischer Einsatz
Zeigen Sie Ihre kommenden Events mit Live-Verfügbarkeit auf Ihrer eigenen Website oder App und leiten Sie Käufer zum Billetto-Checkout weiter.
Bestellungen und Teilnehmer
Sehen Sie, wer was wann für welches Event gekauft hat.
GET /organiser/orderslistet Bestellungen über alle Ihre EventsGET /organiser/events/{event_id}/attendeeslistet die Teilnehmer eines Events- Ergebnisse kommen seitenweise: Rufen Sie die nächste Seite ab, bis keine mehr kommt
Typischer Einsatz
Halten Sie Käuferdaten in Ihrem CRM aktuell oder senden Sie Teilnehmerlisten an ein Einlass- oder Akkreditierungssystem.
Buchungseinträge und Berichte
Erhalten Sie die finanziellen Details hinter Ihren Ticketverkäufen.
GET /organiser/ledger_entrieslistet Verkäufe, Erstattungen, Gebühren und Auszahlungen- Ein BI-Bericht pro Event mit den wichtigsten Verkaufszahlen
Typischer Einsatz
Laden Sie Umsätze in Ihre Buchhaltung oder Ihr Data Warehouse und gleichen Sie sie mit Ihren Auszahlungen ab.
Zielgruppen und Mitglieder
Schreiben Sie Daten zurück zu Billetto, statt sie nur zu lesen.
- Mitglieder von Zielgruppen anlegen, aktualisieren und entfernen
- Ganze Listen importieren und den Importstatus verfolgen
- Eine Zielgruppe und ihre Mitgliederzahl abrufen
Typischer Einsatz
Synchronisieren Sie Mitglieder, Abonnenten oder Partnerlisten aus Ihrem CRM mit Audiences für Presales und exklusive Angebote.
Webhook-Abonnements
Verwalten Sie Webhooks per Code statt in der Billetto-Oberfläche.
POST /organiser/webhooksregistriert eine Endpunkt-URL- Einen bestehenden Webhook aktualisieren oder entfernen
- Ein neues Signatur-Secret für einen Webhook erzeugen
Typischer Einsatz
Registrieren Sie Webhooks automatisch, wenn ein neuer Kunde oder eine neue Umgebung eingerichtet wird, und tauschen Sie Secrets nach Plan aus.
Public Event Search
Durchsuchen Sie Events, die öffentlich auf Billetto gelistet sind, über alle Veranstalter hinweg.
- Abfrageparameter zum Eingrenzen der Ergebnisse, in der Referenz beschrieben
- Jedes Ergebnis verlinkt auf die Eventseite und den Checkout
Typischer Einsatz
Medien, Stadtführer und Partnerplattformen zeigen damit, was los ist, mit Tickets, die über Billetto verkauft werden.
IN DER PRAXIS
Die Billetto API und Webhooks, Schritt für Schritt
APISchritt 1: Zugang
Schlüsselpaar erstellen und den ersten Aufruf senden
Öffnen Sie Integrations, wechseln Sie zum Tab Developers und erstellen Sie ein Schlüsselpaar für das System, das Sie anbinden. Kopieren Sie das Secret, fügen Sie es Ihren Request-Headern hinzu und rufen Sie einen Endpunkt wie /organiser/orders auf. Die Antwort ist JSON, das Sie direkt in Ihr eigenes Datenmodell übernehmen können.
- Ein Schlüsselpaar pro Integration, benannt nach dem System, das es nutzt
- JSON-Antworten für Events, Bestellungen, Teilnehmer und Buchungseinträge
- Ein Schlüsselpaar jederzeit widerrufen, ohne die anderen zu beeinträchtigen
Integrations
Example dataAPI - Key pairs
+ Create key pairAUDIENCESSchritt 2: an Billetto schreiben
Kontakte per API zu einer Zielgruppe hinzufügen
Die Audiences-Endpunkte sind der wichtigste Weg, Daten in Billetto zu schreiben. Senden Sie Kontakte aus Ihrem CRM an eine Zielgruppe oder importieren Sie eine ganze Liste und prüfen Sie den Status, bis sie fertig ist. Danach ist die Gruppe bereit für Einladungen, Presales und exklusive Angebote.
- Mitglieder einzeln hinzufügen, aktualisieren und entfernen
- Massenimporte mit einem Status, den Sie abfragen können
- Gruppen erscheinen sofort in Audiences
Audiences
Example dataVIP members 2026Synced via API
WEBHOOKSSchritt 3: Billetto-Webhooks
Webhook registrieren und Zustellungen live sehen
Fügen Sie Ihre Endpunkt-URL im Tab Developers hinzu, und Billetto erzeugt ein Signatur-Secret dafür. Ab dann wird jede Bestellung, Erstattung, Teilnehmeränderung oder Event-Veröffentlichung als HTTP POST mit JSON-Body an Ihre URL gesendet.
- Einrichtung in der Oberfläche oder per POST /organiser/webhooks
- Ein Signatur-Secret pro Webhook, das Sie neu erzeugen können
- Die Webhooks-Karte zeigt URL und API-Version jedes Webhooks
Integrations
Example dataWebhooks
Receive data based on specific webhook events
Recent deliveriesLive
Was Billetto-Webhooks sind und wann Sie sie nutzen
Ein Webhook ist eine URL auf Ihrem Server, die Billetto aufruft, wenn sich in Ihrem Konto etwas ändert. Statt die API alle paar Minuten nach neuen Bestellungen zu fragen, erhalten Sie einen Aufruf in dem Moment, in dem eine Bestellung angelegt, erstattet oder geändert wird.
Deshalb sind Webhooks das richtige Werkzeug, wenn Timing zählt: eine Bestätigung im CRM innerhalb von Sekunden, eine Slack-Nachricht, wenn ein VIP-Ticket verkauft wird, oder ein Einlasssystem, das von einem stornierten Ticket wissen muss, bevor die Türen öffnen.
Webhooks oder API?
- Nutzen Sie Webhooks, um auf Änderungen zu reagieren, sobald sie passieren: neue Bestellungen, Erstattungen, Teilnehmeränderungen und veröffentlichte Events
- Nutzen Sie die API, um Historie zu laden, einen nächtlichen Komplettabgleich auszuführen oder Details abzurufen, die ein Webhook nicht enthält
- Nutzen Sie beides für die zuverlässigste Lösung: Webhooks für Tempo und einen geplanten API-Abgleich, der alles auffängt, was Sie verpasst haben
So wird ein Billetto-Webhook zugestellt
Vom Verkauf eines Tickets bis zur Verarbeitung in Ihrem System.Einen zuverlässigen Webhook-Empfänger bauen
Sicherheit
- Prüfen Sie jeden Aufruf mit dem Signatur-Secret des Webhooks, bevor Sie dem Inhalt vertrauen. Die Webhook-Referenz beschreibt, wie
- Akzeptieren Sie nur HTTPS und speichern Sie das Secret in der Serverkonfiguration, nicht im Code
- Erzeugen Sie ein neues Secret, wenn es offengelegt worden sein könnte, und aktualisieren Sie dann Ihren Empfänger
Zuverlässigkeit
- Antworten Sie schnell. Geben Sie einen 2xx-Status zurück, sobald der Aufruf geprüft ist, und erledigen Sie die aufwendige Arbeit in einer Queue
- Behandeln Sie Duplikate. Speichern Sie verarbeitete IDs, damit dieselbe Bestellung nie doppelt angelegt wird
- Verlassen Sie sich nicht auf die Reihenfolge. Wenn sie wichtig ist, rufen Sie den aktuellen Stand der Bestellung über die API ab
- Gleichen Sie regelmäßig ab. Ein geplanter API-Abgleich fängt auf, was Ihr Endpunkt während eines Ausfalls verpasst hat
Billetto API-Referenz
Die API-Referenz dokumentiert jeden Endpunkt mit Parametern, Beispielaufrufen und Antwortobjekten. Nutzen Sie sie zusammen mit diesem Guide, wenn Sie mit dem Programmieren beginnen: Finden Sie oben die passende Ressource und schlagen Sie dann die genauen Felder in der Referenz nach.
Webhook-Referenz
Die Webhook-Ressource enthält die Konfiguration eines Endpunkts: seine URL, die verwendete API-Version und sein Signatur-Secret. Wir empfehlen, den ersten Webhook in Billetto unter Integrations → Developers anzulegen und ihn per API zu verwalten, sobald Ihr Setup wächst.
Public Event Search API
Die Public Event Search API liefert Events, die Veranstalter öffentlich auf Billetto gelistet haben, über alle Veranstalter hinweg. Sie eignet sich für Medienseiten, Stadtführer, Tourismusorganisationen und Partner-Apps, die zeigen wollen, was los ist, wobei jedes Ergebnis auf die Billetto-Eventseite verlinkt, auf der Tickets gekauft werden.
Fragen zur Billetto API und zu Webhooks
Technische Fragen von Entwicklern, die mit der Billetto API arbeiten. Fehlt eine Antwort? Sprechen Sie mit unserem Team.
Melden Sie sich bei Billetto an, öffnen Sie Integrations und wechseln Sie zum Tab Developers. Unter API - Key pairs können Sie ein neues Schlüsselpaar erstellen, sehen, wem jedes gehört, und nicht mehr genutzte Schlüssel widerrufen.
Ein Schlüsselpaar gibt Ihren eigenen Systemen Zugriff auf Ihr eigenes Veranstalterkonto. OAuth 2.0 ist für Apps, die andere Veranstalter mit ihrem Billetto-Konto verbinden, sodass Sie in ihrem Namen handeln, ohne ihre Anmeldedaten zu kennen.
Webhooks decken Änderungen an Bestellungen, Teilnehmern und Events ab, etwa neue Bestellungen, Erstattungen, Teilnehmeränderungen und veröffentlichte Events. Die Webhook-Referenz listet alle Ereignisse und ihre Inhalte.
Jeder Webhook hat sein eigenes Signatur-Secret. Prüfen Sie damit jeden eingehenden Aufruf, bevor Sie ihn verarbeiten, und lehnen Sie Aufrufe ab, die die Prüfung nicht bestehen. Sie können jederzeit ein neues Secret für einen Webhook erzeugen.
Ja. Sie können Webhooks über die Webhook-Endpunkte registrieren, aktualisieren und entfernen und für einen bestehenden Webhook ein neues Signatur-Secret erzeugen. Die meisten Teams starten in der Oberfläche und wechseln zur API, wenn sie mehrere Umgebungen verwalten.
429 bedeutet, dass Sie zu viele Aufrufe senden. Warten Sie und versuchen Sie es mit wachsender Pause erneut, und nutzen Sie Webhooks statt häufigem Polling, um die Zahl der Aufrufe niedrig zu halten.
Ja. Nutzen Sie die Public Event Search API für öffentlich gelistete Events auf Billetto oder den Events-Endpunkt des Veranstalters für Ihre eigenen Events. Käufer schließen den Kauf im Billetto-Checkout ab.
Ja. Google Analytics 4, das Meta Pixel, Zapier und Ihr eigener Zahlungsanbieter lassen sich ohne Code verbinden. Unter Billetto-Integrationen sehen Sie, was Sie in wenigen Minuten einrichten können.
Denmark