--- title: "Get a webhook each time you take a ticket order | Ticket Fairy Guides" description: "Add a webhook on the Webhooks page of your brand, a tour or an event, and each order reaches an address you own seconds after the buyer pays, with its tickets, add-ons, totals and ticket holder details." canonical: "https://www.ticketfairy.com/guides/get-a-webhook-when-a-ticket-sells" --- 1. [Ticket Fairy](https://www.ticketfairy.com/) 2. [Guides](https://www.ticketfairy.com/guides) 3. Get a webhook each time you take a ticket order Developers and the API # Get a webhook each time you take a ticket order When your own CRM, warehouse or fulfillment system, or a Zap in Zapier, needs every ticket order, a webhook sends each one to a web address you own the moment the buyer pays. Your system then has each sale as it happens, and again whenever the order is changed, transferred or refunded, rather than waiting for a nightly export. Takes: 6 minutes [Watch the video: Get a webhook each time you take a ticket order](https://d3lcdr963b5ubl.cloudfront.net/uploads/guides/video/get-a-webhook-when-a-ticket-sells/93204eff79a9dbbe3fd0dfc1f32ef3d511e34c0a4ec31ba9ab0f8f4a3692b04f/fe10ea677aac40b5/guide.mp4) · [English](https://www.ticketfairy.com/resources/captions/guides/guide-get-a-webhook-when-a-ticket-sells-fe10ea677aac.vtt) ***Watch how it's done** 3 min 51 s, with captions.* - [Open the Webhooks page](#step-1) - [Brand, tour and event orders](#step-2) - [The webhook key for Zapier](#step-3) - [Start a new webhook](#step-4) - [Enter the address](#step-5) - [Choose what to send](#step-6) - [Choose the format](#step-7) - [Save the webhook](#step-8) - [Send a test](#step-9) - [Check a real order arrives](#step-10) ## Before you start - You're an owner or admin of the brand, event or tour. Ask an owner to add the webhook if your role is lower. - You have the web address your tool gave you, and it starts with https://. 1. ## Open the Webhooks page [Play from here](#guide-video) Open the brand, event or tour whose orders you want, then select **Webhooks**. **Note:** The page lists every webhook on that brand, event or tour, whoever added it. ![The Webhooks page with three webhooks: a Full order feed, a Zap added from Zapier and a paused event updates feed](https://www.ticketfairy.com/embeds/posters/marketing-webhooks--list.png) *Brand, Webhooks.* ## Brand, tour and event orders [Play from here](#guide-video) A webhook on an event receives that event's orders. A webhook on the brand receives the orders of every event on the brand, and one on a tour receives the orders of every event on that tour. New events, event updates and published events go to brand and tour webhooks only, so on an event's Webhooks page you can choose only Orders. ## The webhook key for Zapier [Play from here](#guide-video) Zapier asks for the key under **Webhook API Key** in your account settings when you connect it. A webhook that Zapier adds shows **Added from Zapier** on the Webhooks page, where you turn it off, test it or delete it like any other. **Note:** Select **Generate Webhook API Key** when you have no key yet. A webhook you add on the Webhooks page calls your address directly and needs no key. ![The 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. ## Start a new webhook [Play from here](#guide-video) Select **Add webhook**. ![The Add webhook dialog with Web address, Orders and Full order chosen, and Send updates turned on](https://www.ticketfairy.com/embeds/posters/marketing-webhooks--add-dialog.png) *Webhooks, Add webhook.* 3. ## Enter the address [Play from here](#guide-video) Paste the address your tool gave you into **Web address**. **Note:** The address must start with https://, because each delivery carries buyer and ticket holder details. 4. ## Choose what to send [Play from here](#guide-video) Under **What to send**, keep **Orders**. - **Orders**: Each order when the buyer pays, and again when it is changed, transferred or refunded. - **New events**: Each event you create, on a brand or a tour. - **Event updates**: Each change to an event's details, on a brand or a tour. - **Event published**: Each event when it goes on sale for buyers, on a brand or a tour. 5. ## Choose the format [Play from here](#guide-video) Under **Format**, keep **Full order**. - **Full order**: The buyer, tickets with their ticket categories and types, seats, tables, add-ons, checkout answers, ticket holder details and totals. - **Zapier**: The layout a Zap in Zapier reads. - **Standard**: The layout older webhooks use, for a tool that already reads it. - **Symmetry**: The layout Symmetry reads. - **Iterable**: The layout Iterable reads. **Tip:** Give your developer the link **Developers: see what each format contains** under the choices. It opens every field of the Full order format, and how to check each delivery came from Ticket Fairy. 6. ## Save the webhook [Play from here](#guide-video) Select **Add webhook** at the foot of the dialog. The webhook appears in the list, switched on. **Note:** **Send updates** is on unless you turn it off first, so the next order goes to your address. 7. ## Send a test [Play from here](#guide-video) Select **Send test** on the webhook. "Your address received the test." appears under it when your tool accepted the delivery. **Note:** The test carries example data, not a real order. When your tool refuses it, the message under the webhook gives the code your address answered with. ![A webhook in the list with Your address received the test. under it](https://www.ticketfairy.com/embeds/posters/marketing-webhooks--test-received.png) *Webhooks, Send test.* 8. ## Check a real order arrives [Play from here](#guide-video) Buy one ticket yourself and check the order reaches your tool. **Note:** The order arrives within a few seconds, after the payment is taken. Refund your own order afterwards, and your tool receives the order again with the refund on it. ## Or have it done for you Fai, your AI teammate, can check sales, update your event or change a ticket when you ask. Fai can list, add, change, test and delete the webhooks on a brand, a tour or an event, and she asks for your approval before each change. She shows each address without the part after the question mark, where a tool often keeps its access token. If your address has a question mark or a password in it, add it on the Webhooks page instead, so the access key stays out of the chat. ### In your dashboard, with Fai ``` Add a webhook to that sends every order to in the Full order format, then send it a test ``` ## From your terminal Install the CLI from [our CLI page](https://www.ticketfairy.com/cli), sign in with `ticketfairy auth login`, and choose the brand you are working on with `ticketfairy brand use `. `ticketfairy brand list` and `ticketfairy event list` show the IDs the other commands use. Add a webhook from the command line with a personal access token, then read back the webhooks on the brand you are working on. ### 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 ``` ## Pause or change a webhook [Play from here](#guide-video) 1. ### Turn a webhook off Turn off the switch beside the webhook. It changes from **On** to **Off**. **Note:** The webhook keeps its address and format and sends nothing until you turn it on again. 2. ### Change the address or the format Select the pencil beside the webhook, change **Web address** or **Format**, then select **Save changes**. **Note:** You can't change what a webhook sends. To send something else, add a new webhook. Fai can turn a webhook off or on, or change its address or format, after you approve the change. ### In your dashboard, with Fai ``` Turn off the webhook that sends orders to , and ask me before you save it ``` ### From your terminal Read the webhooks, then switch one off or on again. #### Show the webhooks on the active brand ``` ticketfairy webhook list ``` #### Turn a webhook off without deleting it ``` ticketfairy webhook update --disable ``` ## Delete a webhook [Play from here](#guide-video) 1. ### Start deleting the webhook Select the bin beside the webhook. 2. ### Confirm the deletion Check the address in **Delete this webhook?**, then select **Delete webhook**. **Note:** Any tool that uses the address, such as a Zap in Zapier, stops receiving your orders. To start again after deleting, add the address again. ![The Delete this webhook? confirmation naming the webhook address, with Delete webhook and Cancel](https://www.ticketfairy.com/embeds/posters/marketing-webhooks--delete-confirm.png) *Webhooks, bin, Delete this webhook?* Fai can delete a webhook after you approve it. Before you approve, she tells you which address the webhook will stop sending to. ### In your dashboard, with Fai ``` Delete the webhook that sends orders to , and ask me before you delete it ``` ### From your terminal Read the webhooks, then delete one. #### Show the webhooks on the active brand ``` ticketfairy webhook list ``` #### Delete a webhook ``` ticketfairy webhook delete ``` ## Questions you might have **Why can I choose only Orders on an event's Webhooks page?** New events, event updates and published events go to brand and tour webhooks only, so a webhook on a single event sends orders. To hear about your events, add the webhook on the brand or the tour instead. **What happens when my address is down?** That delivery fails and is not sent again, and the next order is sent as normal. When your address answers 410 Gone, Ticket Fairy deletes the webhook, which is the clean way to stop deliveries 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 system recomputes with the same secret. The developer page at /developers/webhooks shows how. **Will the same order reach me more than once?** Yes. We send the whole order again every time it changes, so you get it again after a refund, a cancellation, a resale or a transfer. If you add a webhook on the brand and another on one of its events with the same address, you also get each order twice. Match on the order number and apply what you receive, rather than counting every delivery as a new sale. **Can I send orders to an address on my own computer?** The Webhooks page accepts only addresses that start with https://, and a test needs one too. For a tool running on your own computer, use a tunnel service that gives you an https address, and point the live webhook at your real system once it works. **Should I turn a webhook off or delete it?** Turn it off while you work on your own system: it keeps its address and format and starts again when you turn it on. Delete it once nothing uses the address any more. **Who can see and change the webhooks?** Owners and admins of the brand, event or tour see every webhook on it and can change, test or delete any of them, whoever added it. Each webhook shows who added it and when. ## Still have a question? Book a demo and we will answer it on a call, on your kind of event. Or create your account and see it for yourself. [Book a demo](https://www.ticketfairy.com/event-ticketing/book-a-demo) [Create a free account](https://manage.ticketfairy.com/welcome) No setup fees. No monthly fee. No credit card required. ## Related guides - [More ways to use Ticket Fairy](https://www.ticketfairy.com/features/api-and-developers) - [Create an API key so your own tools can read your ticket sales](https://www.ticketfairy.com/guides/create-an-api-key-for-your-own-app) - [Sell tickets on your own website](https://www.ticketfairy.com/guides/sell-tickets-on-your-own-website) - [Sync your ticket buyers to Mailchimp](https://www.ticketfairy.com/guides/sync-buyers-to-mailchimp) - [Every Ticket Fairy guide](https://www.ticketfairy.com/guides) ## Do this on your own event Create your account, build your event and follow the steps in your own dashboard. You do not need to book a sales call. [Create a free account](https://manage.ticketfairy.com/welcome) [Book a demo](https://www.ticketfairy.com/event-ticketing/book-a-demo) ## Sell tickets with Ticket Fairy Start free with unlimited events and no monthly fee, and choose a paid plan when you need more. - Set up your event in minutes - Free events are free - Fai, your AI teammate, is built in [Create a free account](https://manage.ticketfairy.com/welcome) No setup fees. No monthly fee. No credit card required. ## See it on a call Book a demo and we will show you how Ticket Fairy handles your kind of event. [Book a demo](https://www.ticketfairy.com/event-ticketing/book-a-demo) [More ways to use Ticket Fairy](https://www.ticketfairy.com/features/api-and-developers) ### Tips for selling more tickets Practical advice from working event organizers, and every new guide as it is published. We respect your privacy. Unsubscribe anytime. --- This page is on Ticket Fairy, a ticketing, marketing and operations platform for live events and the venues that host them: festivals, club nights, concerts, conferences and tours, and night clubs, beach clubs and concert venues. It grows revenue with fan rewards that turn an audience into a sales channel, and runs the money side with payments and payouts, Vault business banking, and working capital advanced against ticket sales. [How Ticket Fairy ticketing works](https://www.ticketfairy.com/event-ticketing) · [Ticket Fairy for AI assistants](https://www.ticketfairy.com/llms.txt)