Pp Eventbrite

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/media-and-entertainment/eventbrite/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Eventbrite — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the eventbrite-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install eventbrite --cli-only

2. Verify: eventbrite-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/eventbrite/cmd/eventbrite-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Use this CLI when an agent manages an organizer's Eventbrite presence: creating and publishing events, pulling order and attendee history, and answering cross-event questions (which events sell slowest, which fans return, who the top buyers are, how a discount code performed) that the per-event dashboard and existing single-org MCP servers cannot answer. It is the right tool whenever the task needs the whole order/attendee history in one place rather than a single live API lookup. When the same promoter also sells on DICE, both CLIs emit JSON and a local SQLite store, so an agent can join the two datasets by event (name and date) and by buyer email for a cross-platform performance and loyalty picture.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Cross-event sales analytics

• sales-velocity — Ranks all your live events by tickets sold per day since on-sale and projects a sell-out date.

  Reach for this when an agent needs to know which of an organizer's events are underperforming right now, not just current totals.

  eventbrite-pp-cli sales-velocity --json

• discount-performance — Per discount code: redemptions, type, and the redemption rate (share of the code's allotment used).

  Pick this to measure whether a promo code actually drove sales before renewing or killing it.

  eventbrite-pp-cli discount-performance --json

• capacity — Sold vs total capacity and percent remaining across all your live events at once.

  Use this to spot which events are near sell-out or badly under-sold in a single call.

  eventbrite-pp-cli capacity --json

• refund-rate — Refunded and cancelled order counts, refunded revenue, and the rate per event or across the org.

  Pick this to flag events with abnormal refund rates that signal a pricing, date, or fulfillment problem.

  eventbrite-pp-cli refund-rate --json

• top-buyers — Ranks ticket buyers by total spend across all your events, not just by how many events they attended.

  Reach for this to find an organizer's highest-value customers for VIP or pre-sale outreach.

  eventbrite-pp-cli top-buyers --limit 25 --json

Search your own data offline

• repeat-attendees — Finds fans who bought into two or more of your events, across your whole synced history.

  Use this for loyalty and re-marketing questions an agent cannot answer from any one event's attendee list.

  eventbrite-pp-cli repeat-attendees --min 2 --json

• roster — Offline attendee roster for one event with checked-in vs not-yet, VIP and comp flags, door-sorted.

  Reach for this at the door when an agent needs a fast who-has-not-checked-in list without a live API round-trip.

  eventbrite-pp-cli roster 1234567890 --csv

• fan-export — Exports unique attendee contacts (email, name, events attended, check-in status), deduped across all your events and filterable by event.

  Use this to build a clean, deduped contact list for an email campaign across an organizer's whole audience.

  eventbrite-pp-cli fan-export --csv

Agency multi-org view

• org-rollup — Single pane across every organization your token can see: events count, tickets sold, gross, and top event per org.

  Use this for an agency or multi-brand operator who needs one client roll-up instead of logging into each org.

  eventbrite-pp-cli org-rollup --json

Command Reference

balance — Manage balance

categories — <a name="categories_object"></a>

Category Object

An overarching category that an event falls into (vertical). Examples are “Music”, and “Endurance”.

• eventbrite-pp-cli categories category-by-id — Gets a category by ID as category.
• eventbrite-pp-cli categories list-of — Returns a list of Category as categories, including subcategories nested. Returns a paginated response.

discounts — <a name="discount_object"></a>

Discount Object

The Discount object represents a discount that an Order owner can use when purchasing tickets to an Event.

A Discount can be used to a single Ticket Class or across multiple Ticket Classes for multiple Events simultaneously (known as a cross event Discount).

There are four types of Discounts:

• Public Discount. Publically displays Discount to Order owner on the Event Listing and Checkout pages. Only used with a single Event.

• Coded Discount. Requires Order owner to use a secret code to access the Discount.

• Access Code. Requires Order owner to use a secret code to access hidden tickets. Access codes can also optionally contain a discount amount.

• Hold Discount. Allows Order owner to apply or unlock Discount for seats on hold.

The display price of a ticket is calculated as:
price_before_discount - discount_amount = display_price

Notes:

• Public and Coded Discounts can specify either an amount off or a percentage off, but not both types discounts.

• Public Discounts should not contain apostrophes or non-alphanumeric characters (except “-���, “_”, ” ”, “(”, ”)”, “/”, and “”).

• Coded Discounts and Access Codes should not contain spaces, apostrophes or non-alphanumeric characters (except “-”, “_”, “(”, ”)”, “/”, and “”).

Fields

Use these fields to specify information about a Discount.

The following conditions define the extend of the Discount:

• If event_id is provided and ticket_class_ids are not provided, a single Event Discount is created for all Event tickets.

• If both event_id and ticket_class_ids are provided, a single Event Discount is created for the specific Event tickets.

• If ticket_group_id is provided, a Discount is created for the Ticket Group.

• If neither event_id nor ticket_group_id are provided, a Discount is created that applies to all tickets for an Organization's Events, including future Events.

Expansions

Information from expansions fields are not normally returned when requesting information. To receive this information in a request, expand the request.

• eventbrite-pp-cli discounts delete-a — Delete a Discount. Only unused Discounts can be deleted.
• eventbrite-pp-cli discounts retrieve-a — Retrieve a Discount by Discount ID.
• eventbrite-pp-cli discounts update-a — Update a Discount by Discount ID.

event — <a name="event_object"></a>

Event Object

The Event object represents an Eventbrite Event. An Event is owned by one Organization.

Public Fields

Use these fields to specify information about an Event. For publicly listed Events, this information can be retrieved by all Eventbrite Users and Eventbrite applications.

Private Fields

Use these fields to specify properties of an Event that are only available to the User.

<a name="music_properties_object"></a>

Music Properties

The Music Properties object includes a few attributes of an event for Music clients. To retrieve Music Properties by Event ID, use the music_properties expansion.

<a name="event_expansions" />

Expansions

Information from expansions fields are not normally returned when requesting information. To receive this information in a request, expand the request.

events — <a name="event_object"></a>

Event Object

The Event object represents an Eventbrite Event. An Event is owned by one Organization.

Public Fields

Use these fields to specify information about an Event. For publicly listed Events, this information can be retrieved by all Eventbrite Users and Eventbrite applications.

Private Fields

Use these fields to specify properties of an Event that are only available to the User.

<a name="music_properties_object"></a>

Music Properties

The Music Properties object includes a few attributes of an event for Music clients. To retrieve Music Properties by Event ID, use the music_properties expansion.

<a name="event_expansions" />

Expansions

Information from expansions fields are not normally returned when requesting information. To receive this information in a request, expand the request.

• eventbrite-pp-cli events delete-an — Delete an Event if the delete is permitted. Returns a boolean indicating the success or failure of the delete action.
• eventbrite-pp-cli events retrieve-an — Retrieve an Event by Event ID.
• eventbrite-pp-cli events update-an — Update Event by Event ID.

formats — <a name="formats_object"></a>

Format Object

The Format object represents an Event type, for example seminar, workshop or concert. Specifying a Format helps website visitors discover a certain type of Event.

• eventbrite-pp-cli formats list — List all available Formats. Returns a paginated response.
• eventbrite-pp-cli formats retrieve-a — Retrieve a Format by Format ID.

media — <!-- Here is a tutorial on [Media Upload in EventBrite](https://www.eventbrite.com/developer/v3/resources/uploads/). -->

<a name="media_object"></a>

Media Object

The Media object represents an image that can be included with an Event listing, for example to provide branding or further information on the Event.

• eventbrite-pp-cli media retrieve — Retrieve Media by Media ID.
• eventbrite-pp-cli media retrieve-a-upload — Retrieve information on a Media image upload.
• eventbrite-pp-cli media upload-a-file — Upload a Media image file.

orders — <a name="order_object"></a>

Order object

The Order object represents an order made against Eventbrite for one or more Ticket Classes. In other words, a single Order can be made up of multiple tickets. The object contains an Order's financial and transactional information; use the Attendee object to return information on Attendees.

Order objects are considered private; meaning that all Order information is only available to the Eventbrite User and Order owner.

Order Fields

<a name="order_cost"></a>

Order Costs Fields

Contains a breakdown of Order costs.

<a name="order_display_tax"></a>