pretix
App · 11 actions
Run your pretix ticket sales from workflows: get and find orders and their attendees, add orders, mark them paid or cancel them, resend order links, make voucher codes, check what's left and check attendees in. Start a workflow on a new, paid or canceled order.
Actions
| Action | What it does |
|---|---|
| Cancel order | Cancel a whole order, so its tickets no longer work and go back on sale. |
| Check availability | See how many tickets are left for an event or one product, quota by quota, with how many are paid and pending. |
| Check in attendee | Check an attendee in with their ticket's code, as scanning it at the door does. |
| Create order | Add an order for tickets of one product, such as a free registration or a ticket sold elsewhere, as pending payment or paid. |
| Create vouchers | Make voucher codes for an event: discounts, set prices or codes that unlock hidden products, with the codes you give or new random ones. |
| Find orders | Find orders by the buyer's email address, status, a name or code, or the day they were placed, newest first, with their tickets. |
| Find vouchers | Find an event's vouchers by code, tag or text, newest first, with how often each was used. |
| Get order | Get an order with its tickets and attendees, its status and payment, and the buyer's order page. |
| List events | List the organizer's events, soonest first, with their dates, place and shop link. |
| Mark order paid | Mark a pending or expired order as paid, such as when a bank transfer arrives. |
| Resend order link | Email the buyer the link to their order page again, where they find their tickets and can pay. |
Cancel order
Cancel a whole order, so its tickets no longer work and go back on sale. It refunds nothing: refunds are made in pretix.
Inputs
- Event
eventtextRequired - The event: pick it, or type its short name as in its shop's address, such as meetup.
- Order
ordertextRequired - The order's code, such as FBSY7, from a trigger or an earlier step.
- Email the buyer
send_emailtrue/false - Send the buyer pretix's cancellation email.Default:
true. - Note to the buyer
commenttext - Why it was canceled. pretix puts it in the cancellation email.
Outputs
admin_urltext- The order in pretix's control panel
buyer_nametext- The buyer's name from the invoice address, if asked for
canceled_attext- When it was canceled, if it is
changedtrue/false- False when the order already had that status, so nothing was done
codetext- The order's code, such as FBSY7, for other pretix steps
commenttext- The internal comment on the order
companytext- The buyer's company, if given
created_attext- When it was placed (ISO 8601, UTC)
currencytext- The currency, such as EUR
emailtext- The buyer's email address
eventtext- The event's short name
event_nametext- The event's name
expires_attext- When an unpaid order expires
paidtrue/false- Whether the order is paid
paid_attext- When it was paid, if it is
payment_methodtext- How it's paid, such as banktransfer, stripe or free
phonetext- The buyer's phone number, if asked for
statustext- pending, paid, expired or canceled
test_modetrue/false- Whether it was placed in test mode
ticket_countnumber- How many tickets it has, not counting canceled ones
ticketslist- The tickets bought, one per attendee
totalnumber- The order's total
updated_attext- When it last changed
urltext- The buyer's own order page, with their tickets
Example output
{
"admin_url": "https://pretix.eu/control/event/example/meetup/orders/FBSY7/",
"buyer_name": "Ada Lovelace",
"canceled_at": "2026-11-07T10:00:00Z",
"changed": true,
"code": "FBSY7",
"comment": "",
"company": "",
"created_at": "2026-11-05T16:02:33Z",
"currency": "EUR",
"email": "ada@example.com",
"event": "meetup",
"event_name": "Summer Meetup",
"expires_at": "2026-11-19T22:59:59Z",
"paid": false,
"paid_at": "2026-11-06T09:10:00Z",
"payment_method": "banktransfer",
"phone": "",
"status": "canceled",
"test_mode": false,
"ticket_count": 0,
"tickets": [
{
"attendee_email": "ada@example.com",
"attendee_name": "Ada Lovelace",
"canceled": true,
"checked_in": false,
"checked_in_at": "",
"id": 12,
"price": 25.0,
"product": "Regular ticket",
"product_id": 1,
"ticket_secret": "ruftp787g8e4zxvmu3zujvw863r9kcgh"
}
],
"total": 25.0,
"updated_at": "2026-11-06T09:10:00Z",
"url": "https://pretix.eu/example/meetup/order/FBSY7/ke84mg802l6rt8o9/"
}Check availability
See how many tickets are left for an event or one product, quota by quota, with how many are paid and pending.
Inputs
- Event
eventtextRequired - The event: pick it, or type its short name as in its shop's address, such as meetup.
- Product
producttext - Only the quotas of this product. Leave blank for the whole event.
Outputs
availabletrue/false- Whether any tickets can be bought now
eventtext- The event's short name
leftnumber- How many are left: for a product, the fewest any of its quotas has; for the event, all its quotas together. Empty if unlimited
product_idnumber- The product asked about; 0 for the whole event
quotaslist- Each quota, with what is sold and left
unlimitedtrue/false- Whether an open quota has no limit
Example output
{
"available": true,
"event": "meetup",
"left": 97,
"product_id": 0,
"quotas": [
{
"available": true,
"closed": false,
"date_id": 0,
"id": 1,
"in_carts": 0,
"left": 97,
"name": "General admission",
"paid": 2,
"pending": 1,
"product_ids": [
1,
2
],
"products": [
"Regular ticket",
"Student ticket"
],
"size": 100,
"unlimited": false
}
],
"unlimited": false
}Check in attendee
Check an attendee in with their ticket's code, as scanning it at the door does. Says why when pretix won't, such as already checked in.
Inputs
- Event
eventtextRequired - The event: pick it, or type its short name as in its shop's address, such as meetup.
- Ticket code
tickettextRequired - The code in the ticket's QR code, or a ticket's ticket_secret from 'Get order' or a trigger.
- Check-in list
checkin_listtext - The check-in list to use. Leave blank if the event has only one.
Outputs
attendee_emailtext- The attendee's email address
attendee_nametext- The attendee's name
checked_intrue/false- Whether the attendee is now checked in
checkin_list_idnumber- The check-in list used
messagetext- The answer in words
needs_attentiontrue/false- Whether the ticket is marked for special attention at entry
ordertext- The ticket's order code, if pretix knows the ticket
reasontext- Why not, such as already_redeemed, unpaid or invalid
statustext- pretix's answer: ok, or error
ticket_secrettext- The ticket code that was checked
Example output
{
"attendee_email": "ada@example.com",
"attendee_name": "Ada Lovelace",
"checked_in": true,
"checkin_list_id": 1,
"message": "Checked in.",
"needs_attention": false,
"order": "FBSY7",
"reason": "",
"status": "ok",
"ticket_secret": "ruftp787g8e4zxvmu3zujvw863r9kcgh"
}Create order
Add an order for tickets of one product, such as a free registration or a ticket sold elsewhere, as pending payment or paid.
Inputs
- Event
eventtextRequired - The event: pick it, or type its short name as in its shop's address, such as meetup.
- Product
producttextRequired - The product to order.
- Buyer email
emailtextRequired - Where pretix sends the order and its tickets.
- Attendee name
attendee_nametext - The name on the tickets.
- Attendee email
attendee_emailtext - The attendee's own email address, if not the buyer's.
- Quantity
quantitynumber - How many tickets. Defaults to 1.From 1 to 20.
- Mark as paid
paidtrue/false - Record the order as paid, for one paid outside pretix. Free orders are paid anyway.Default:
false. - Email the buyer
send_emailtrue/false - Send the buyer pretix's order confirmation.Default:
true. - Internal comment
commenttext - A note on the order, seen only in pretix's control panel.
Outputs
admin_urltext- The order in pretix's control panel
buyer_nametext- The buyer's name from the invoice address, if asked for
canceled_attext- When it was canceled, if it is
codetext- The order's code, such as FBSY7, for other pretix steps
commenttext- The internal comment on the order
companytext- The buyer's company, if given
created_attext- When it was placed (ISO 8601, UTC)
currencytext- The currency, such as EUR
emailtext- The buyer's email address
eventtext- The event's short name
event_nametext- The event's name
expires_attext- When an unpaid order expires
paidtrue/false- Whether the order is paid
paid_attext- When it was paid, if it is
payment_methodtext- How it's paid, such as banktransfer, stripe or free
phonetext- The buyer's phone number, if asked for
statustext- pending, paid, expired or canceled
test_modetrue/false- Whether it was placed in test mode
ticket_countnumber- How many tickets it has, not counting canceled ones
ticketslist- The tickets bought, one per attendee
totalnumber- The order's total
updated_attext- When it last changed
urltext- The buyer's own order page, with their tickets
Example output
{
"admin_url": "https://pretix.eu/control/event/example/meetup/orders/FBSY7/",
"buyer_name": "Ada Lovelace",
"canceled_at": "",
"code": "FBSY7",
"comment": "",
"company": "",
"created_at": "2026-11-05T16:02:33Z",
"currency": "EUR",
"email": "ada@example.com",
"event": "meetup",
"event_name": "Summer Meetup",
"expires_at": "2026-11-19T22:59:59Z",
"paid": true,
"paid_at": "2026-11-06T09:10:00Z",
"payment_method": "banktransfer",
"phone": "",
"status": "paid",
"test_mode": false,
"ticket_count": 1,
"tickets": [
{
"attendee_email": "ada@example.com",
"attendee_name": "Ada Lovelace",
"canceled": false,
"checked_in": false,
"checked_in_at": "",
"id": 12,
"price": 25.0,
"product": "Regular ticket",
"product_id": 1,
"ticket_secret": "ruftp787g8e4zxvmu3zujvw863r9kcgh"
}
],
"total": 25.0,
"updated_at": "2026-11-06T09:10:00Z",
"url": "https://pretix.eu/example/meetup/order/FBSY7/ke84mg802l6rt8o9/"
}Create vouchers
Make voucher codes for an event: discounts, set prices or codes that unlock hidden products, with the codes you give or new random ones.
Inputs
- Event
eventtextRequired - The event: pick it, or type its short name as in its shop's address, such as meetup.
- Codes
codestext - The codes to make, one per line. Leave blank for random codes.
- How many
how_manynumber - How many random codes to make when no codes are given. Defaults to 1.From 1 to 100.
- Product
producttext - Only for this product. Leave blank for any product.
- Discount
discount_typetext - What the voucher does to the price.One of:
none(No discount (only unlocks)),percent(Percentage off),amount(Amount off),price(Set price). Default:none. - Value
valuenumber - The percentage or amount off, or the price, such as 20.Only when Discount is Percentage off, Amount off or Set price. At least 0.
- Uses per code
max_usesnumber - How many tickets each code can be used for. Defaults to 1.At least 1.
- Valid until
valid_untildate - The last day the codes work, to its end.
- Tag
tagtext - A tag to find this batch by, such as speakers.
- Internal comment
commenttext - A note on the vouchers, seen only in pretix's control panel.
Outputs
codeslist- Just their codes, in the same order
countnumber- How many were made
voucherslist- The vouchers made
Example output
{
"codes": [
"GDPNFK9LAA"
],
"count": 1,
"vouchers": [
{
"code": "GDPNFK9LAA",
"comment": "",
"discount_type": "percent",
"event": "meetup",
"id": 7,
"max_uses": 1,
"product": "Regular ticket",
"product_id": 1,
"shop_url": "https://pretix.eu/example/meetup/redeem?voucher=GDPNFK9LAA",
"tag": "speakers",
"times_used": 0,
"uses_left": 1,
"valid_until": "2027-06-01T21:59:59Z",
"value": 20.0
}
]
}Find orders
Find orders by the buyer's email address, status, a name or code, or the day they were placed, newest first, with their tickets.
Inputs
- Event
eventtext - Only this event's orders. Leave blank for every event.
- Buyer email
emailtext - Only orders placed with this email address.
- Status
statustext - Only orders with this status.One of:
pending(Pending (not paid yet)),paid,expired,canceled. - Search
searchtext - An attendee's or buyer's name, or an order code, or part of one.
- Placed since
created_fromdate - Only orders placed on or after this day.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 200.
Outputs
countnumber- How many were found
orderslist- The orders found, newest first
Example output
{
"count": 1,
"orders": [
{
"admin_url": "https://pretix.eu/control/event/example/meetup/orders/FBSY7/",
"buyer_name": "Ada Lovelace",
"canceled_at": "",
"code": "FBSY7",
"comment": "",
"company": "",
"created_at": "2026-11-05T16:02:33Z",
"currency": "EUR",
"email": "ada@example.com",
"event": "meetup",
"event_name": "Summer Meetup",
"expires_at": "2026-11-19T22:59:59Z",
"paid": true,
"paid_at": "2026-11-06T09:10:00Z",
"payment_method": "banktransfer",
"phone": "",
"status": "paid",
"test_mode": false,
"ticket_count": 1,
"tickets": [
{
"attendee_email": "ada@example.com",
"attendee_name": "Ada Lovelace",
"canceled": false,
"checked_in": false,
"checked_in_at": "",
"id": 12,
"price": 25.0,
"product": "Regular ticket",
"product_id": 1,
"ticket_secret": "ruftp787g8e4zxvmu3zujvw863r9kcgh"
}
],
"total": 25.0,
"updated_at": "2026-11-06T09:10:00Z",
"url": "https://pretix.eu/example/meetup/order/FBSY7/ke84mg802l6rt8o9/"
}
]
}Find vouchers
Find an event's vouchers by code, tag or text, newest first, with how often each was used.
Inputs
- Event
eventtextRequired - The event: pick it, or type its short name as in its shop's address, such as meetup.
- Code
codetext - The exact voucher code.
- Search
searchtext - Part of a code, tag or comment.
- Tag
tagtext - Only vouchers with this tag.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 200.
Outputs
countnumber- How many were found
voucherslist- The vouchers found, newest first
Example output
{
"count": 1,
"vouchers": [
{
"code": "GDPNFK9LAA",
"comment": "",
"discount_type": "percent",
"event": "meetup",
"id": 7,
"max_uses": 1,
"product": "Regular ticket",
"product_id": 1,
"shop_url": "https://pretix.eu/example/meetup/redeem?voucher=GDPNFK9LAA",
"tag": "speakers",
"times_used": 0,
"uses_left": 1,
"valid_until": "2027-06-01T21:59:59Z",
"value": 20.0
}
]
}Get order
Get an order with its tickets and attendees, its status and payment, and the buyer's order page.
Inputs
- Event
eventtextRequired - The event: pick it, or type its short name as in its shop's address, such as meetup.
- Order
ordertextRequired - The order's code, such as FBSY7, from a trigger or an earlier step.
Outputs
admin_urltext- The order in pretix's control panel
buyer_nametext- The buyer's name from the invoice address, if asked for
canceled_attext- When it was canceled, if it is
codetext- The order's code, such as FBSY7, for other pretix steps
commenttext- The internal comment on the order
companytext- The buyer's company, if given
created_attext- When it was placed (ISO 8601, UTC)
currencytext- The currency, such as EUR
emailtext- The buyer's email address
eventtext- The event's short name
event_nametext- The event's name
expires_attext- When an unpaid order expires
paidtrue/false- Whether the order is paid
paid_attext- When it was paid, if it is
payment_methodtext- How it's paid, such as banktransfer, stripe or free
phonetext- The buyer's phone number, if asked for
statustext- pending, paid, expired or canceled
test_modetrue/false- Whether it was placed in test mode
ticket_countnumber- How many tickets it has, not counting canceled ones
ticketslist- The tickets bought, one per attendee
totalnumber- The order's total
updated_attext- When it last changed
urltext- The buyer's own order page, with their tickets
Example output
{
"admin_url": "https://pretix.eu/control/event/example/meetup/orders/FBSY7/",
"buyer_name": "Ada Lovelace",
"canceled_at": "",
"code": "FBSY7",
"comment": "",
"company": "",
"created_at": "2026-11-05T16:02:33Z",
"currency": "EUR",
"email": "ada@example.com",
"event": "meetup",
"event_name": "Summer Meetup",
"expires_at": "2026-11-19T22:59:59Z",
"paid": true,
"paid_at": "2026-11-06T09:10:00Z",
"payment_method": "banktransfer",
"phone": "",
"status": "paid",
"test_mode": false,
"ticket_count": 1,
"tickets": [
{
"attendee_email": "ada@example.com",
"attendee_name": "Ada Lovelace",
"canceled": false,
"checked_in": false,
"checked_in_at": "",
"id": 12,
"price": 25.0,
"product": "Regular ticket",
"product_id": 1,
"ticket_secret": "ruftp787g8e4zxvmu3zujvw863r9kcgh"
}
],
"total": 25.0,
"updated_at": "2026-11-06T09:10:00Z",
"url": "https://pretix.eu/example/meetup/order/FBSY7/ke84mg802l6rt8o9/"
}List events
List the organizer's events, soonest first, with their dates, place and shop link.
Inputs
- Only upcoming
upcoming_onlytrue/false - Leave out events that have ended.Default:
true. - How many
limitnumber - The most to list. Defaults to 25.From 1 to 200.
Outputs
countnumber- How many there are
eventslist- The events, soonest first
Example output
{
"count": 1,
"events": [
{
"admin_url": "https://pretix.eu/control/event/example/meetup/",
"currency": "EUR",
"ends_at": "2027-06-12T21:00:00Z",
"has_dates": false,
"location": "Kulturbrauerei, Berlin",
"name": "Summer Meetup",
"on_sale": true,
"public": true,
"shop_url": "https://pretix.eu/example/meetup/",
"slug": "meetup",
"starts_at": "2027-06-12T16:00:00Z",
"test_mode": false,
"time_zone": "Europe/Berlin"
}
]
}Mark order paid
Mark a pending or expired order as paid, such as when a bank transfer arrives. Nothing changes if it's already paid.
Inputs
- Event
eventtextRequired - The event: pick it, or type its short name as in its shop's address, such as meetup.
- Order
ordertextRequired - The order's code, such as FBSY7, from a trigger or an earlier step.
- Email the buyer
send_emailtrue/false - Send the buyer pretix's payment confirmation with their tickets.Default:
true.
Outputs
admin_urltext- The order in pretix's control panel
buyer_nametext- The buyer's name from the invoice address, if asked for
canceled_attext- When it was canceled, if it is
changedtrue/false- False when the order already had that status, so nothing was done
codetext- The order's code, such as FBSY7, for other pretix steps
commenttext- The internal comment on the order
companytext- The buyer's company, if given
created_attext- When it was placed (ISO 8601, UTC)
currencytext- The currency, such as EUR
emailtext- The buyer's email address
eventtext- The event's short name
event_nametext- The event's name
expires_attext- When an unpaid order expires
paidtrue/false- Whether the order is paid
paid_attext- When it was paid, if it is
payment_methodtext- How it's paid, such as banktransfer, stripe or free
phonetext- The buyer's phone number, if asked for
statustext- pending, paid, expired or canceled
test_modetrue/false- Whether it was placed in test mode
ticket_countnumber- How many tickets it has, not counting canceled ones
ticketslist- The tickets bought, one per attendee
totalnumber- The order's total
updated_attext- When it last changed
urltext- The buyer's own order page, with their tickets
Example output
{
"admin_url": "https://pretix.eu/control/event/example/meetup/orders/FBSY7/",
"buyer_name": "Ada Lovelace",
"canceled_at": "",
"changed": true,
"code": "FBSY7",
"comment": "",
"company": "",
"created_at": "2026-11-05T16:02:33Z",
"currency": "EUR",
"email": "ada@example.com",
"event": "meetup",
"event_name": "Summer Meetup",
"expires_at": "2026-11-19T22:59:59Z",
"paid": true,
"paid_at": "2026-11-06T09:10:00Z",
"payment_method": "banktransfer",
"phone": "",
"status": "paid",
"test_mode": false,
"ticket_count": 1,
"tickets": [
{
"attendee_email": "ada@example.com",
"attendee_name": "Ada Lovelace",
"canceled": false,
"checked_in": false,
"checked_in_at": "",
"id": 12,
"price": 25.0,
"product": "Regular ticket",
"product_id": 1,
"ticket_secret": "ruftp787g8e4zxvmu3zujvw863r9kcgh"
}
],
"total": 25.0,
"updated_at": "2026-11-06T09:10:00Z",
"url": "https://pretix.eu/example/meetup/order/FBSY7/ke84mg802l6rt8o9/"
}Resend order link
Email the buyer the link to their order page again, where they find their tickets and can pay.
Inputs
- Event
eventtextRequired - The event: pick it, or type its short name as in its shop's address, such as meetup.
- Order
ordertextRequired - The order's code, such as FBSY7, from a trigger or an earlier step.
Outputs
codetext- The order's code
emailtext- Where the link was sent
eventtext- The event's short name
senttrue/false- Whether pretix sent it
urltext- The order page the email links to
Example output
{
"code": "FBSY7",
"email": "ada@example.com",
"event": "meetup",
"sent": true,
"url": "https://pretix.eu/example/meetup/order/FBSY7/ke84mg802l6rt8o9/"
}