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

ActionWhat it does
Cancel orderCancel a whole order, so its tickets no longer work and go back on sale.
Check availabilitySee how many tickets are left for an event or one product, quota by quota, with how many are paid and pending.
Check in attendeeCheck an attendee in with their ticket's code, as scanning it at the door does.
Create orderAdd an order for tickets of one product, such as a free registration or a ticket sold elsewhere, as pending payment or paid.
Create vouchersMake voucher codes for an event: discounts, set prices or codes that unlock hidden products, with the codes you give or new random ones.
Find ordersFind orders by the buyer's email address, status, a name or code, or the day they were placed, newest first, with their tickets.
Find vouchersFind an event's vouchers by code, tag or text, newest first, with how often each was used.
Get orderGet an order with its tickets and attendees, its status and payment, and the buyer's order page.
List eventsList the organizer's events, soonest first, with their dates, place and shop link.
Mark order paidMark a pending or expired order as paid, such as when a bank transfer arrives.
Resend order linkEmail 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

EventeventtextRequired
The event: pick it, or type its short name as in its shop's address, such as meetup.
OrderordertextRequired
The order's code, such as FBSY7, from a trigger or an earlier step.
Email the buyersend_emailtrue/false
Send the buyer pretix's cancellation email.Default: true.
Note to the buyercommenttext
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

EventeventtextRequired
The event: pick it, or type its short name as in its shop's address, such as meetup.
Productproducttext
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

EventeventtextRequired
The event: pick it, or type its short name as in its shop's address, such as meetup.
Ticket codetickettextRequired
The code in the ticket's QR code, or a ticket's ticket_secret from 'Get order' or a trigger.
Check-in listcheckin_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

EventeventtextRequired
The event: pick it, or type its short name as in its shop's address, such as meetup.
ProductproducttextRequired
The product to order.
Buyer emailemailtextRequired
Where pretix sends the order and its tickets.
Attendee nameattendee_nametext
The name on the tickets.
Attendee emailattendee_emailtext
The attendee's own email address, if not the buyer's.
Quantityquantitynumber
How many tickets. Defaults to 1.From 1 to 20.
Mark as paidpaidtrue/false
Record the order as paid, for one paid outside pretix. Free orders are paid anyway.Default: false.
Email the buyersend_emailtrue/false
Send the buyer pretix's order confirmation.Default: true.
Internal commentcommenttext
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

EventeventtextRequired
The event: pick it, or type its short name as in its shop's address, such as meetup.
Codescodestext
The codes to make, one per line. Leave blank for random codes.
How manyhow_manynumber
How many random codes to make when no codes are given. Defaults to 1.From 1 to 100.
Productproducttext
Only for this product. Leave blank for any product.
Discountdiscount_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.
Valuevaluenumber
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 codemax_usesnumber
How many tickets each code can be used for. Defaults to 1.At least 1.
Valid untilvalid_untildate
The last day the codes work, to its end.
Tagtagtext
A tag to find this batch by, such as speakers.
Internal commentcommenttext
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

Eventeventtext
Only this event's orders. Leave blank for every event.
Buyer emailemailtext
Only orders placed with this email address.
Statusstatustext
Only orders with this status.One of: pending (Pending (not paid yet)), paid, expired, canceled.
Searchsearchtext
An attendee's or buyer's name, or an order code, or part of one.
Placed sincecreated_fromdate
Only orders placed on or after this day.
How manylimitnumber
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

EventeventtextRequired
The event: pick it, or type its short name as in its shop's address, such as meetup.
Codecodetext
The exact voucher code.
Searchsearchtext
Part of a code, tag or comment.
Tagtagtext
Only vouchers with this tag.
How manylimitnumber
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

EventeventtextRequired
The event: pick it, or type its short name as in its shop's address, such as meetup.
OrderordertextRequired
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 upcomingupcoming_onlytrue/false
Leave out events that have ended.Default: true.
How manylimitnumber
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

EventeventtextRequired
The event: pick it, or type its short name as in its shop's address, such as meetup.
OrderordertextRequired
The order's code, such as FBSY7, from a trigger or an earlier step.
Email the buyersend_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/"
}

Email the buyer the link to their order page again, where they find their tickets and can pay.

Inputs

EventeventtextRequired
The event: pick it, or type its short name as in its shop's address, such as meetup.
OrderordertextRequired
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/"
}

On this page