# pretix

> 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.

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/pretix

## Actions

### 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 (`event`, text, required): The event: pick it, or type its short name as in its shop's address, such as meetup.
- Order (`order`, text, required): The order's code, such as FBSY7, from a trigger or an earlier step.
- Email the buyer (`send_email`, true/false): Send the buyer pretix's cancellation email. Default: `true`.
- Note to the buyer (`comment`, text): Why it was canceled. pretix puts it in the cancellation email.

**Outputs**

- `admin_url` (text): The order in pretix's control panel
- `buyer_name` (text): The buyer's name from the invoice address, if asked for
- `canceled_at` (text): When it was canceled, if it is
- `changed` (true/false): False when the order already had that status, so nothing was done
- `code` (text): The order's code, such as FBSY7, for other pretix steps
- `comment` (text): The internal comment on the order
- `company` (text): The buyer's company, if given
- `created_at` (text): When it was placed (ISO 8601, UTC)
- `currency` (text): The currency, such as EUR
- `email` (text): The buyer's email address
- `event` (text): The event's short name
- `event_name` (text): The event's name
- `expires_at` (text): When an unpaid order expires
- `paid` (true/false): Whether the order is paid
- `paid_at` (text): When it was paid, if it is
- `payment_method` (text): How it's paid, such as banktransfer, stripe or free
- `phone` (text): The buyer's phone number, if asked for
- `status` (text): pending, paid, expired or canceled
- `test_mode` (true/false): Whether it was placed in test mode
- `ticket_count` (number): How many tickets it has, not counting canceled ones
- `tickets` (list): The tickets bought, one per attendee
- `total` (number): The order's total
- `updated_at` (text): When it last changed
- `url` (text): The buyer's own order page, with their tickets

**Example output**

```json
{
  "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 (`event`, text, required): The event: pick it, or type its short name as in its shop's address, such as meetup.
- Product (`product`, text): Only the quotas of this product. Leave blank for the whole event.

**Outputs**

- `available` (true/false): Whether any tickets can be bought now
- `event` (text): The event's short name
- `left` (number): 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_id` (number): The product asked about; 0 for the whole event
- `quotas` (list): Each quota, with what is sold and left
- `unlimited` (true/false): Whether an open quota has no limit

**Example output**

```json
{
  "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 (`event`, text, required): The event: pick it, or type its short name as in its shop's address, such as meetup.
- Ticket code (`ticket`, text, required): The code in the ticket's QR code, or a ticket's ticket_secret from 'Get order' or a trigger.
- Check-in list (`checkin_list`, text): The check-in list to use. Leave blank if the event has only one.

**Outputs**

- `attendee_email` (text): The attendee's email address
- `attendee_name` (text): The attendee's name
- `checked_in` (true/false): Whether the attendee is now checked in
- `checkin_list_id` (number): The check-in list used
- `message` (text): The answer in words
- `needs_attention` (true/false): Whether the ticket is marked for special attention at entry
- `order` (text): The ticket's order code, if pretix knows the ticket
- `reason` (text): Why not, such as already_redeemed, unpaid or invalid
- `status` (text): pretix's answer: ok, or error
- `ticket_secret` (text): The ticket code that was checked

**Example output**

```json
{
  "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 (`event`, text, required): The event: pick it, or type its short name as in its shop's address, such as meetup.
- Product (`product`, text, required): The product to order.
- Buyer email (`email`, text, required): Where pretix sends the order and its tickets.
- Attendee name (`attendee_name`, text): The name on the tickets.
- Attendee email (`attendee_email`, text): The attendee's own email address, if not the buyer's.
- Quantity (`quantity`, number): How many tickets. Defaults to 1. From 1 to 20.
- Mark as paid (`paid`, true/false): Record the order as paid, for one paid outside pretix. Free orders are paid anyway. Default: `false`.
- Email the buyer (`send_email`, true/false): Send the buyer pretix's order confirmation. Default: `true`.
- Internal comment (`comment`, text): A note on the order, seen only in pretix's control panel.

**Outputs**

- `admin_url` (text): The order in pretix's control panel
- `buyer_name` (text): The buyer's name from the invoice address, if asked for
- `canceled_at` (text): When it was canceled, if it is
- `code` (text): The order's code, such as FBSY7, for other pretix steps
- `comment` (text): The internal comment on the order
- `company` (text): The buyer's company, if given
- `created_at` (text): When it was placed (ISO 8601, UTC)
- `currency` (text): The currency, such as EUR
- `email` (text): The buyer's email address
- `event` (text): The event's short name
- `event_name` (text): The event's name
- `expires_at` (text): When an unpaid order expires
- `paid` (true/false): Whether the order is paid
- `paid_at` (text): When it was paid, if it is
- `payment_method` (text): How it's paid, such as banktransfer, stripe or free
- `phone` (text): The buyer's phone number, if asked for
- `status` (text): pending, paid, expired or canceled
- `test_mode` (true/false): Whether it was placed in test mode
- `ticket_count` (number): How many tickets it has, not counting canceled ones
- `tickets` (list): The tickets bought, one per attendee
- `total` (number): The order's total
- `updated_at` (text): When it last changed
- `url` (text): The buyer's own order page, with their tickets

**Example output**

```json
{
  "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 (`event`, text, required): The event: pick it, or type its short name as in its shop's address, such as meetup.
- Codes (`codes`, text): The codes to make, one per line. Leave blank for random codes.
- How many (`how_many`, number): How many random codes to make when no codes are given. Defaults to 1. From 1 to 100.
- Product (`product`, text): Only for this product. Leave blank for any product.
- Discount (`discount_type`, text): 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 (`value`, number): 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_uses`, number): How many tickets each code can be used for. Defaults to 1. At least 1.
- Valid until (`valid_until`, date): The last day the codes work, to its end.
- Tag (`tag`, text): A tag to find this batch by, such as speakers.
- Internal comment (`comment`, text): A note on the vouchers, seen only in pretix's control panel.

**Outputs**

- `codes` (list): Just their codes, in the same order
- `count` (number): How many were made
- `vouchers` (list): The vouchers made

**Example output**

```json
{
  "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 (`event`, text): Only this event's orders. Leave blank for every event.
- Buyer email (`email`, text): Only orders placed with this email address.
- Status (`status`, text): Only orders with this status. One of: `pending` (Pending (not paid yet)), `paid`, `expired`, `canceled`.
- Search (`search`, text): An attendee's or buyer's name, or an order code, or part of one.
- Placed since (`created_from`, date): Only orders placed on or after this day.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many were found
- `orders` (list): The orders found, newest first

**Example output**

```json
{
  "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 (`event`, text, required): The event: pick it, or type its short name as in its shop's address, such as meetup.
- Code (`code`, text): The exact voucher code.
- Search (`search`, text): Part of a code, tag or comment.
- Tag (`tag`, text): Only vouchers with this tag.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many were found
- `vouchers` (list): The vouchers found, newest first

**Example output**

```json
{
  "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 (`event`, text, required): The event: pick it, or type its short name as in its shop's address, such as meetup.
- Order (`order`, text, required): The order's code, such as FBSY7, from a trigger or an earlier step.

**Outputs**

- `admin_url` (text): The order in pretix's control panel
- `buyer_name` (text): The buyer's name from the invoice address, if asked for
- `canceled_at` (text): When it was canceled, if it is
- `code` (text): The order's code, such as FBSY7, for other pretix steps
- `comment` (text): The internal comment on the order
- `company` (text): The buyer's company, if given
- `created_at` (text): When it was placed (ISO 8601, UTC)
- `currency` (text): The currency, such as EUR
- `email` (text): The buyer's email address
- `event` (text): The event's short name
- `event_name` (text): The event's name
- `expires_at` (text): When an unpaid order expires
- `paid` (true/false): Whether the order is paid
- `paid_at` (text): When it was paid, if it is
- `payment_method` (text): How it's paid, such as banktransfer, stripe or free
- `phone` (text): The buyer's phone number, if asked for
- `status` (text): pending, paid, expired or canceled
- `test_mode` (true/false): Whether it was placed in test mode
- `ticket_count` (number): How many tickets it has, not counting canceled ones
- `tickets` (list): The tickets bought, one per attendee
- `total` (number): The order's total
- `updated_at` (text): When it last changed
- `url` (text): The buyer's own order page, with their tickets

**Example output**

```json
{
  "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_only`, true/false): Leave out events that have ended. Default: `true`.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many there are
- `events` (list): The events, soonest first

**Example output**

```json
{
  "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 (`event`, text, required): The event: pick it, or type its short name as in its shop's address, such as meetup.
- Order (`order`, text, required): The order's code, such as FBSY7, from a trigger or an earlier step.
- Email the buyer (`send_email`, true/false): Send the buyer pretix's payment confirmation with their tickets. Default: `true`.

**Outputs**

- `admin_url` (text): The order in pretix's control panel
- `buyer_name` (text): The buyer's name from the invoice address, if asked for
- `canceled_at` (text): When it was canceled, if it is
- `changed` (true/false): False when the order already had that status, so nothing was done
- `code` (text): The order's code, such as FBSY7, for other pretix steps
- `comment` (text): The internal comment on the order
- `company` (text): The buyer's company, if given
- `created_at` (text): When it was placed (ISO 8601, UTC)
- `currency` (text): The currency, such as EUR
- `email` (text): The buyer's email address
- `event` (text): The event's short name
- `event_name` (text): The event's name
- `expires_at` (text): When an unpaid order expires
- `paid` (true/false): Whether the order is paid
- `paid_at` (text): When it was paid, if it is
- `payment_method` (text): How it's paid, such as banktransfer, stripe or free
- `phone` (text): The buyer's phone number, if asked for
- `status` (text): pending, paid, expired or canceled
- `test_mode` (true/false): Whether it was placed in test mode
- `ticket_count` (number): How many tickets it has, not counting canceled ones
- `tickets` (list): The tickets bought, one per attendee
- `total` (number): The order's total
- `updated_at` (text): When it last changed
- `url` (text): The buyer's own order page, with their tickets

**Example output**

```json
{
  "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 (`event`, text, required): The event: pick it, or type its short name as in its shop's address, such as meetup.
- Order (`order`, text, required): The order's code, such as FBSY7, from a trigger or an earlier step.

**Outputs**

- `code` (text): The order's code
- `email` (text): Where the link was sent
- `event` (text): The event's short name
- `sent` (true/false): Whether pretix sent it
- `url` (text): The order page the email links to

**Example output**

```json
{
  "code": "FBSY7",
  "email": "ada@example.com",
  "event": "meetup",
  "sent": true,
  "url": "https://pretix.eu/example/meetup/order/FBSY7/ke84mg802l6rt8o9/"
}
```
