# Get a webhook each time you take a ticket order | Ticket Fairy Anleitungen 1. [Ticket Fairy](https://www.ticketfairy.com/) 2. [Anleitungen](https://www.ticketfairy.com/de/guides) 3. Get a webhook each time you take a ticket order Entwickler und die API # Get a webhook each time you take a ticket order A webhook posts every order to an address you own, seconds after the buyer pays. Agencies and promoters with their own CRM, warehouse or fulfilment system get each sale as it happens, rather than waiting for a nightly export. Have Ticket Fairy send each new order to an address you own, seconds after the buyer pays, so your own systems get the sale without asking for it on a timer. Für: Sending each ticket sale to your own systems as it happens Dauer: 8 Minuten - [Generate the webhook key](#step-1) - [Point a webhook at your own address](#step-2) - [Choose what sets it off](#step-3) - [When to put a webhook on the brand rather than the event](#step-4) - [Attach it where it should listen](#step-5) - [Sell a ticket and watch it arrive](#step-6) ## Bevor Sie anfangen - You have an address that answers a POST and returns quickly. Use HTTPS for a real endpoint, because each request carries order and buyer details. - You have a personal access token for the command line. Creating one has its own guide. - You know which events should feed it: one event, everything under a brand, or everything on a tour. 1. ## Generate the webhook key Open your account settings and select **Generate Webhook API Key** under **Webhook API Key**. **Hinweis:** Platforms such as Zapier ask for this key when you connect them. A webhook you create yourself calls your address directly and needs nothing from this card. ![Ticket Fairy Webhook API Key card showing the key with a control to copy it and one to regenerate it](https://www.ticketfairy.com/embeds/posters/marketing-developer-access--api-keys.png) The webhook key, once it has been generated. 2. ## Point a webhook at your own address Run "ticketfairy webhook create --url https://example.com/hooks/tickets --on order" against the brand you are working on. **Hinweis:** Each order is posted to that address as JSON. Answer with a success code quickly and do the slow work afterwards, so a busy on-sale never waits on you. 3. ## Choose what sets it off Pass the one thing you want to hear about in "--on": "order" for orders, or "new\_event", "update\_event", "publish\_event" and "find\_event" for the event itself. **Hinweis:** One webhook carries one notification, so a system that wants orders and publications needs two of them. ## When to put a webhook on the brand rather than the event Attach a webhook to one event when only that event should feed your system, and to the brand when every event should. A whole tour has its own attachment. The four event notifications are the exception that decides it for you: "new\_event", "update\_event", "publish\_event" and "find\_event" reach brand and tour webhooks only, and never one attached to a single event, so a system that wants to hear about publications needs its webhook on the brand. 4. ## Attach it where it should listen Pass "--event", "--brand" or "--tour" on the command that creates it. **Hinweis:** The command falls back to the brand you are working on when none of the three is given. 5. ## Sell a ticket and watch it arrive Buy one ticket yourself and check the request reaches your address. **Hinweis:** Delivery happens in the background rather than inside the checkout, so allow a few seconds. Refund your own order afterwards. ## Probiere diese Schritte bei deinem eigenen Event aus Erstelle ein kostenloses Konto, lege dein Event an und folge den Schritten oben in deinem eigenen Dashboard. Das dauert ein paar Minuten, und du musst kein Verkaufsgespräch buchen. Deine E-Mail-Adresse [Kostenloses Konto erstellen](https://manage.ticketfairy.com/welcome) [Demo buchen](https://www.ticketfairy.com/de/event-ticketing/book-a-demo) Keine Einrichtungsgebühren. Keine verpflichtende monatliche Ticketing-Gebühr. Keine Kreditkarte nötig. ## Oder lassen Sie es erledigen Fai can open the page holding the webhook key. The webhooks themselves are created from the command line, and the steps below show the commands. ### In Ihrem Dashboard, mit Fai Open my account settings so I can get my webhook key ### Über MCP, mit Ihrem eigenen Assistenten Verbinden Sie Ihren Assistenten mit [unserem MCP-Server](https://www.ticketfairy.com/mcp-server) und bitten Sie ihn: Lassen Sie `--read-only` in Ihrer MCP-Konfiguration. Diese Aufgabe liest nur Daten, deshalb braucht Ihr Assistent keine Werkzeuge für Änderungen. Pick the brand \ and show its events ## Über das Terminal Installieren Sie die CLI über [unserer CLI-Seite](https://www.ticketfairy.com/cli), melden Sie sich mit `ticketfairy auth login` an und wählen Sie mit `ticketfairy brand use ` die Marke, an der Sie arbeiten. `ticketfairy brand list` und `ticketfairy event list` zeigen die IDs, die die anderen Befehle verwenden. Create the webhook, then read back what is listening. ### Call your address every time an order is placed ticketfairy webhook create --url https://example.com/hooks/tickets --on order ### Show the webhooks on the active brand ticketfairy webhook list ## Lass Fai das für dich erledigen Fai arbeitet in deinem Ticket Fairy Dashboard. Erstelle dein Konto, öffne Fai und füge die Anweisung von oben ein. [Kostenloses Konto erstellen](https://manage.ticketfairy.com/welcome) [Demo buchen](https://www.ticketfairy.com/de/event-ticketing/book-a-demo) Keine Einrichtungsgebühren. Keine verpflichtende monatliche Ticketing-Gebühr. Keine Kreditkarte nötig. ## Take one out of service 1. ### Switch it off while you work on your end Run "ticketfairy webhook update \ --disable", taking the id from "ticketfairy webhook list". **Hinweis:** A disabled webhook keeps its settings and stops receiving. Bring it back with the same command and "--enable". 2. ### Remove one you have finished with Run "ticketfairy webhook delete \" once nothing needs it. **Hinweis:** Deleting is permanent, so disable first when you only want a pause. Fai can open the dashboard for you. Webhooks are read and changed from the command line today. ### In Ihrem Dashboard, mit Fai Open my account settings ### Über MCP, mit Ihrem eigenen Assistenten Lassen Sie `--read-only` in Ihrer MCP-Konfiguration. Diese Aufgabe liest nur Daten, deshalb braucht Ihr Assistent keine Werkzeuge für Änderungen. Pick the brand \ and show its events ### Über das Terminal Read the webhooks, then switch one off or remove it. #### Show the webhooks on the active brand ticketfairy webhook list #### Stop a webhook receiving without deleting it ticketfairy webhook update \ --disable #### Remove a webhook permanently ticketfairy webhook delete \ ## Fragen, die Sie haben könnten Why did nothing arrive when my event went live?: Check what the webhook is attached to. The event notifications reach brand and tour webhooks only, so one attached to a single event hears about orders alone. What happens when my address is down?: That delivery fails and the next one is tried as normal. Answer 410 Gone and we take the webhook off the list, which is the clean way to unsubscribe from your end. Can I check a request really came from Ticket Fairy?: Yes. Ask Ticket Fairy support to add a signing secret to your event, and every request then carries an X-Signature header your endpoint recomputes with the same secret. Will the same order reach me more than once?: Yes. The whole order is posted again every time it changes, so a refund, a cancellation, a resale or a transfer each send it. Match on the order number and apply what you receive, rather than counting every delivery as a new sale. Can I test against a local address?: A plain http address on your own machine is accepted, so a tunnel is a convenience rather than a requirement. Every request carries order and buyer details, so keep http for testing and give the live system an HTTPS address. ## Hast du noch eine Frage? Buche eine Demo, und wir beantworten sie in einem Gespräch, passend zu deiner Art von Event. Oder erstelle dein Konto und sieh es dir selbst an. [Demo buchen](https://www.ticketfairy.com/de/event-ticketing/book-a-demo) [Kostenloses Konto erstellen](https://manage.ticketfairy.com/welcome) Keine Einrichtungsgebühren. Keine verpflichtende monatliche Ticketing-Gebühr. Keine Kreditkarte nötig. ## Verwandte Anleitungen - [Weitere Möglichkeiten mit Ticket Fairy](https://www.ticketfairy.com/de/event-ticketing/features) - [Create an API key so your own tools can read your ticket sales](https://www.ticketfairy.com/de/guides/create-an-api-key-for-your-own-app) - [Can you sell tickets directly from your own website?](https://www.ticketfairy.com/de/guides/sell-tickets-on-your-own-website) - [Sync your ticket buyers to Mailchimp](https://www.ticketfairy.com/de/guides/sync-buyers-to-mailchimp) - [Alle Ticket Fairy Anleitungen](https://www.ticketfairy.com/de/guides) ## Machen Sie das bei Ihrer eigenen Veranstaltung Erstellen Sie Ihr Konto, legen Sie Ihr Event an und folgen Sie den Schritten in Ihrem eigenen Dashboard. Sie müssen kein Verkaufsgespräch buchen. [Kostenloses Konto erstellen](https://manage.ticketfairy.com/welcome) [Demo buchen](https://www.ticketfairy.com/de/event-ticketing/book-a-demo) ## Verkaufe Tickets mit Ticket Fairy Alles in diesen Anleitungen ist ab dem Tag deiner Registrierung in deinem Dashboard. - Richte dein Event in Minuten ein - Kostenlose Events sind kostenlos - Fai, dein Co-Pilot, ist eingebaut [Kostenloses Konto erstellen](https://manage.ticketfairy.com/welcome) Keine Einrichtungsgebühren. Keine verpflichtende monatliche Ticketing-Gebühr. Keine Kreditkarte nötig. ## Sieh es dir in einem Gespräch an Buche eine Demo, und wir zeigen dir, wie Ticket Fairy deine Art von Event abwickelt. [Demo buchen](https://www.ticketfairy.com/de/event-ticketing/book-a-demo) [Weitere Möglichkeiten mit Ticket Fairy](https://www.ticketfairy.com/de/event-ticketing/features) ### Tipps, um mehr Tickets zu verkaufen Praktische Ratschläge von Veranstaltern, die ausverkaufen, und jede neue Anleitung, sobald sie erscheint. Wir respektieren deine Privatsphäre. Jederzeit abbestellbar.