---
title: "Ticket Fairy API, Webhooks, CLI and MCP Server"
description: "Every paid order reaches your own systems in seconds. Each tool gets its own access token, you can script repeat setup, and AI assistants help within your role."
canonical: "https://www.ticketfairy.com/features/api-and-developers"
---

API & developers

# Send every order to your own systems in seconds

You get each order at your own address seconds after the buyer pays. You can script repeat setup or hand it to your AI assistant, within your permissions.

  [Get started free](https://manage.ticketfairy.com/registration) [Book a demo](https://www.ticketfairy.com/event-ticketing/book-a-demo)    ![Ticket Fairy Personal Access Tokens card listing tokens with their created, last used and expiry dates](https://www.ticketfairy.com/embeds/posters/marketing-developer-access--personal-access-tokens.png)

- Each sale in your own systems in seconds
- No dashboard passwords given to a tool
- You script repeat setup and reports once

- **25,000+** events powered
- **10M+** tickets issued
- **10+** countries
- **20%** more tickets from referral rewards

## Connect your own tools without sharing a password

If your agency or promotion company runs its own CRM, reporting or website, you can connect it to Ticket Fairy directly.

In your account settings, you create a personal access token for each laptop, server, script or agent, name it after the tool that holds it and give it an expiry that suits the job. Each token carries your own role, so it opens only the brands and events you can open, and if a laptop goes missing, you can revoke its token straight away. Your scripts use the Ticket Fairy API to create events and get their sales, and if a script retries after a network error, you still get one event, not two.

- **Personal access tokens**: one for each tool, with its own expiry, revoked at once
- **Ticket Fairy API**: create events and get their sales from your scripts
- **Python client**: public listings with no account, your own events with a token

## Get each order in your systems seconds after buyers pay

Your CRM and reporting stay up to date without anyone exporting a file. With a webhook on a brand, a tour or an event, you get each order at an address you own seconds after the buyer pays, with the tickets, add-ons, totals and ticket holder details.

When someone changes, transfers or refunds an order, you get the whole order again. Brand and tour webhooks can also tell you about new, changed and published events. You can choose the full order, or the format that Zapier, Iterable or Symmetry expects, and connect Zapier with your webhook API key. A test from the Webhooks page checks that your address accepts it.

- **Order webhooks**: for a brand, a tour or one event
- **Zapier**: connect with your webhook API key
- **Send test**: example data that checks your address before your first order

    ![Ticket Fairy API Key and Webhook API Key cards, each 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)

## Sell tickets on your own website or app

Buyers choose tickets and pay without leaving your website. The Event Embed snippet puts your checkout on your event page.

The React checkout SDK gives you a checkout with no Ticket Fairy branding on your own React website, and the React Native checkout SDK sells inside your own iPhone or Android app. Your website can also list your live public events through the public event API, with no key needed.

- **Event Embed**: checkout on your own event page
- **React checkout SDK**: a checkout in your own branding on your React website
- **React Native checkout SDK**: tickets on sale inside your own iOS or Android app

    ![Ticket Fairy Event Embed security page with the website addresses allowed to run the checkout](https://www.ticketfairy.com/embeds/posters/marketing-event-embeds--allowed-sites.png)

## Let your own AI assistant handle routine event jobs

With the Ticket Fairy command-line tool (CLI) installed and signed in once, you can script the setup and reports you repeat, such as copying an event or saving a sales summary every night.

The CLI also runs an MCP server on your own computer, so Claude Code, Cursor and other assistants can see your live sales and do routine setup for you, read-only if you choose. Before a deletion or a cancellation goes ahead, your AI client asks you to approve it. An AI agent that asks to act for you gets access only after you approve it, and you can end that access in Account Settings.

- **Ticket Fairy CLI**: events, tickets, orders and reports from the terminal
- **MCP server**: your assistant acts as you, with your role
- **AI agents you approve**: end an agent's access at any time

[Get Started for Free](https://manage.ticketfairy.com/registration) [Book Demo Call](https://www.ticketfairy.com/event-ticketing/book-a-demo)

## Build on Ticket Fairy with everything your developer needs

- ### Personal access tokens

  Each tool gets a named token with its own expiry. You can rotate it with an overlap so a running job keeps going, and revoke it at once.
- ### Brand API key

  You can generate the key the event APIs ask for, such as your referral leaderboard, and regenerate it when you need a new one.
- ### Ticket Fairy API

  Your own scripts can create events and get their sales, and your developer builds from an OpenAPI description.

  [Learn more](https://www.ticketfairy.com/developers)
- ### Public event API

  Live public events, yours included, list with no account, and you can ask about upcoming events in plain language.

  [Learn more](https://www.ticketfairy.com/developers)
- ### Order webhooks

  You get each order at your own address once the buyer pays, and again whenever someone changes, transfers or refunds it.

  [Learn more](https://www.ticketfairy.com/developers)
- ### Event webhooks

  Webhooks on a brand or a tour tell you about new, changed and published events.

- ### Zapier, Iterable and Symmetry

  Each of these tools gets the webhook format it expects, and you connect Zapier with your webhook API key.
- ### Ticket Fairy CLI

  Events, tickets, orders, customers and your team are all workable from the command line or a scheduled job.

  [Learn more](https://www.ticketfairy.com/cli)
- ### MCP server

  Claude Code, Cursor or another MCP client can connect to your events, starting read-only if you prefer.

  [Learn more](https://www.ticketfairy.com/mcp-server)
- ### AI agent approvals

  Each AI agent that asks to act for you needs your approval, and you can end its access in Account Settings.
- ### Event Embed

  Your checkout can sit on your own event page, so buyers pay without leaving your website.

  [Learn more](https://www.ticketfairy.com/features/event-pages-and-website)
- ### Checkout SDKs

  You can build your own checkout on your React website, or inside your own iPhone or Android app.

  [Learn more](https://www.ticketfairy.com/developers)
- ### Marketing integrations

  Buyers reach Klaviyo, Mailchimp, Laylo and Hive with no code at all.

  [Learn more](https://www.ticketfairy.com/features/integrations)
- ### Fai and your webhooks

  Fai, the AI teammate in your dashboard, can list, add, change, test or delete your webhooks, and asks you to approve each change.

  [Learn more](https://www.ticketfairy.com/features/fai)
- ### Events started by your AI assistant

  An AI assistant can start your event from its name, dates, venue and description. The link it gives you opens sign-up or sign-in, and the event joins your brand as a draft for you to check.
- ### Seat maps and ID checks in your own checkout

  With the React checkout SDK, buyers pick seats on your seat map and pay by card with Stripe or Xendit, and in your app the SDK checks buyers' ID and keeps signed-in buyers signed in.
- ### A checkout in your own colors

  You set the accent, surfaces, text colors, corners and typography in light or dark, or arrange the checkout sections in a layout of your own.
- ### Promo codes and referral credit in your app

  Your checkout can open with a [promo code](https://www.ticketfairy.com/event-ticketing/event-promo-codes) already applied, credit a sale to the referrer who sent the buyer, and show buyers their referral rewards after they pay.
- ### Who set up each webhook

  You see who added each webhook and when, can switch one off and on again without losing its address, and can send a test that tells you whether your address received it.
- ### Tokens no tool uses any more

  You see when each personal access token was last used, so you can revoke the ones no tool needs.

## How It Looks in Your Dashboard

- ![Ticket Fairy Event Embed install page with the checkout code ready to paste](https://www.ticketfairy.com/embeds/posters/marketing-event-embeds--install.png)
  *With the Event Embed code on your event page, buyers pay without leaving your website.*
- ![Ticket Fairy Laylo card on the Integrations page, with the Laylo webhook URL field, Show and Save](https://www.ticketfairy.com/embeds/posters/marketing-brand-integrations--laylo.png)
  *One pasted link sends each paid order to Laylo, with no code needed.*

## Connect your own tools step by step

- [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)
- [Get a webhook each time you take a ticket order](https://www.ticketfairy.com/guides/get-a-webhook-when-a-ticket-sells)
- [Sell tickets on your own website](https://www.ticketfairy.com/guides/sell-tickets-on-your-own-website)

## Questions About API & Developers

### API & developers

#### Do I use a personal access token or the API key?

Use a personal access token for the command line, the MCP server, your own scripts and your agents. Use your brand's API key for the event APIs, such as your referral leaderboard. Regenerating the API key stops every application that uses the old key until you update it.

#### How long does a personal access token last?

A year by default, which is also the longest. Choose a shorter expiry for a one-off script. The token is shown once, so copy it before you close the window. When you rotate a token, the old one still works for up to seven days while you swap it over.

#### How many tokens can I create?

Ten an hour, counting rotations, and you cannot create a new one while fifty are live. You can revoke as many as you like.

#### What happens when my webhook address is down?

That delivery fails and is not sent again, and the next order arrives as normal. If your address answers 410 Gone, we delete the webhook. Webhook addresses must start with https://.

#### Can I check that a webhook request came from Ticket Fairy?

Yes. Add a signing secret to the webhook, and every request then carries an X-Signature header that your system checks with the same secret. The webhook documentation shows how.

#### Will the same order reach my webhook more than once?

Yes. The whole order is sent again each time it changes, and a brand webhook and an event webhook that send to the same address both send it. Match on the order number rather than counting each delivery as a new sale.

#### How do buyers pay in my own app?

Through Stripe. The React Native checkout SDK takes payments with the Stripe React Native SDK, and its documentation lists the setup for iOS and Android.

#### Do the CLI and the MCP server cost anything?

No. Both are free with your Ticket Fairy account and need Node 20 or newer. The MCP server comes with the CLI. Vault commands and tools are for brands with Vault access, and they only read.

#### Can an AI assistant or a token do more than I can?

No. Each one acts as you, with your role and your brands, so it cannot open another brand's data or give itself new permissions.

#### How long does the link from my AI assistant last?

Three days, or until you sign up or sign in with it. The first browser that opens the link holds the event, and the assistant cannot change the event after that.

#### What does the app checkout SDK need?

React Native 0.81 or newer with the New Architecture, React 19.1 or newer, iOS 15.1 or newer and Android API 24 or newer. It needs a development build, because Expo Go cannot load it. Install tf-checkout-react for a website and tf-checkout-react-native for an app, both from npm.

#### Which expiry can I give a personal access token?

An hour, 7 days, 30 days, 90 days or a year, under Set custom expiry. Each teammate creates their own tokens, and revoking one leaves your password and your other tokens working.

#### Can I test a webhook from my own computer?

Yes, through a tunnel service that gives your computer an https address. A test that fails shows the response code your address returned.

#### How do I get a client ID for the checkout SDK?

Open your brand in the dashboard, select Checkout apps and add an app. Enter each website that sells tickets, or none for a mobile app, then copy the client ID and setup code. There is no client secret to keep, and an app sells only your brand's events.

## More of Ticket Fairy

- ### [Add every ticket buyer to your marketing tools](https://www.ticketfairy.com/features/integrations)

  Your ticket buyers reach Klaviyo, Mailchimp, Laylo and Hive without you exporting a list, and you connect each tool once for your whole brand.
- ### [Turn more of your visitors into ticket buyers](https://www.ticketfairy.com/features/event-pages-and-website)

  You can build event pages that answer buyers' questions and give each campaign its own page, test which version sells more and sell tickets on your own website.
- ### [Get your ticketing jobs done by asking Fai](https://www.ticketfairy.com/features/fai)

  You get answers about your sales in seconds, Fai takes on your event setup, promotions and emails, and she prepares your finance work. You approve every change first.
- ### [Give each team member the access their job needs](https://www.ticketfairy.com/features/teams-and-security)

  You can invite your team with the access each job needs and protect your sign-in. Your whole team joins any paid plan with no per-seat price. From your first day, Home shows you where to start.

      [Previous **Integrations**](https://www.ticketfairy.com/features/integrations) [Features **All features**](https://www.ticketfairy.com/features)

See how the Ticket Fairy [ticketing platform for event organizers](https://www.ticketfairy.com/event-ticketing/) helps you sell more tickets, with every feature, the pricing and the support you get.

## Start Selling Tickets Online

Create a free account and build a test event before you commit. Set up your tickets, explore referral rewards and go on sale when you are ready.

Unlimited events with no monthly fee

Start selling tickets immediately

Tickets, door and website tools on every plan, Free included

   [Get Started](https://manage.ticketfairy.com/welcome)

No credit card required

The Ticket Fairy, Inc. is a fintech company and technology platform. The Ticket Fairy, Inc. is not a bank, financial institution, or regulated financial services provider. Vault banking services are provided through regulated banking partners.

---

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)
