# Eventbrite on boxd

> Eventbrite enables organizers to plan, promote, and manage events, selling tickets and providing attendee tools for conferences, concerts, and gatherings.

- Page: https://boxd.sh/integrations/eventbrite/
- CLI: `run eventbrite` (95 commands, 45 marked common)
- SDK: `import { eventbrite } from "@boxd/run"`; every parameter and response type is at `@boxd/run/eventbrite`
- Triggers: none
- Connect: `run auth eventbrite` (Sign in with Eventbrite), or https://app.boxd.sh/integrations/detail/eventbrite
- All integrations: https://boxd.sh/integrations/ (Markdown: https://boxd.sh/integrations/index.md)

## From the shell

```sh
run auth eventbrite      # once: prints a link to connect your account
run eventbrite           # list its commands
run eventbrite get-me
```

Parameters are flags (`--flag value`); object and array parameters take a JSON string. Output is YAML, or JSON with `--json`. Calls use your own connection; `--scope <name>` uses a connection shared with your team.

## From a script

```ts
import { every, eventbrite } from "@boxd/run";

every("1 hour", async () => {
  const result = await eventbrite.getMe();
  console.log(result);
});
```

Run it with `run eventbrite.run.ts`. Eventbrite has no triggers; `every()` polls on a schedule, keeps the script running as a job, and wakes the machine when it is due.

## Commands

Required flags are listed; `run eventbrite <command> --help` lists the optional ones. "common" marks what `run eventbrite` shows without `--all`.

| Command | SDK method | Required flags | Optional | Description |
|---|---|---|---|---|
| `add-ticket-to-group` | `eventbrite.addTicketToGroup()` | `--event-id` `--ticket-class-id` `--ticket-group-ids` | 0 | Add a ticket class to one or more explicitly specified ticket groups for an Eventbrite event |
| `add-ticket-to-group-by-organization` | `eventbrite.addTicketToGroupByOrganization()` | `--event-id` `--organization-id` `--ticket-class-id` `--ticket-group-ids` | 0 | Add a ticket class to ticket groups using organization and event IDs |
| `calculate-price-for-item` | `eventbrite.calculatePriceForItem()` | `--base-price` `--country` `--scope` | 0 | Calculate Eventbrite fees for a given ticket price |
| `cancel-event` | `eventbrite.cancelEvent()` | `--event-id` | 0 | Cancel an Eventbrite event |
| `copy-event` | `eventbrite.copyEvent()` | `--event-id` | 0 | Copy an Eventbrite event and create a duplicate with a new Event ID |
| `create-access-code` ·common | `eventbrite.createAccessCode()` | `--access-code` `--event-id` | 0 | Create a new access code for an Eventbrite event |
| `create-checkout-settings` ·common | `eventbrite.createCheckoutSettings()` | `--checkout-settings` `--organization-id` | 0 | Create checkout settings for an Eventbrite organization |
| `create-custom-question` ·common | `eventbrite.createCustomQuestion()` | `--event-id` `--question` | 0 | Create a custom question for an Eventbrite event |
| `create-discount` ·common | `eventbrite.createDiscount()` | `--discount` `--organization-id` | 0 | Create a new discount for an Eventbrite organization |
| `create-event` ·common | `eventbrite.createEvent()` | `--event` `--organization-id` | 0 | Create a new Eventbrite event |
| `create-event-schedule` | `eventbrite.createEventSchedule()` | `--event-id` `--schedule` | 0 | Create an event schedule for a series parent event |
| `create-inventory-tier` ·common | `eventbrite.createInventoryTier()` | `--event-id` `--inventory-tier` | 0 | Create a new inventory tier for an Eventbrite event |
| `create-organizer` ·common | `eventbrite.createOrganizer()` | `--organization-id` `--organizer` | 0 | Create a new organizer for an Eventbrite organization |
| `create-ticket-class` ·common | `eventbrite.createTicketClass()` | `--event-id` `--ticket-class` | 0 | Create a new ticket class for an Eventbrite event |
| `create-ticket-group` | `eventbrite.createTicketGroup()` | `--organization-id` `--ticket-group` | 0 | Create a new ticket group for an Eventbrite organization |
| `create-tracking-beacon` | `eventbrite.createTrackingBeacon()` | `--tracking-type` | 4 | Create a tracking beacon for an Eventbrite event or user |
| `create-venue` ·common | `eventbrite.createVenue()` | `--organization-id` `--venue` | 0 | Create a new venue under an organization in Eventbrite |
| `create-webhook` | `eventbrite.createWebhook()` | `--actions` `--endpoint-url` `--organization-id` | 1 | Create a new webhook for an Eventbrite organization |
| `delete-default-question` | `eventbrite.deleteDefaultQuestion()` | `--event-id` `--question-id` | 0 | Deactivate a canned question for an event |
| `delete-discount` | `eventbrite.deleteDiscount()` | `--discount-id` | 0 | Delete a discount from Eventbrite |
| `delete-event` | `eventbrite.deleteEvent()` | `--event-id` | 0 | Delete an Eventbrite event |
| `delete-inventory-tier` | `eventbrite.deleteInventoryTier()` | `--event-id` `--inventory-tier-id` | 0 | Mark an existing inventory tier as deleted for an Eventbrite event |
| `delete-ticket-class` | `eventbrite.deleteTicketClass()` | `--event-id` `--ticket-class-id` | 0 | Delete a ticket class from an Eventbrite event by its ID |
| `delete-ticket-group` | `eventbrite.deleteTicketGroup()` | `--ticket-group-id` | 0 | Delete a ticket group by changing its status to deleted |
| `get-access-code` ·common | `eventbrite.getAccessCode()` | `--access-code-id` `--event-id` | 0 | Retrieve a specific access code by ID for an Eventbrite event |
| `get-assortment` | `eventbrite.getAssortment()` | `--organization-id` | 0 | Retrieve assortment information for a specific organization |
| `get-attendee-report` | `eventbrite.getAttendeeReport()` | `--event-ids` `--organization-id` | 8 | Retrieve an attendee report for events in an Eventbrite organization |
| `get-capacity-tier` ·common | `eventbrite.getCapacityTier()` | `--event-id` | 0 | Retrieve the capacity tier for an Eventbrite event |
| `get-category` ·common | `eventbrite.getCategory()` | `--category-id` | 0 | Retrieve a specific category by ID |
| `get-checkout-settings` | `eventbrite.getCheckoutSettings()` | `--organization-id` | 0 | Retrieve checkout settings for a specific Eventbrite organization |
| `get-default-question` | `eventbrite.getDefaultQuestion()` | `--event-id` `--question-id` | 0 | Retrieve a specific default (canned) question for an Eventbrite event by Event ID and Question ID |
| `get-discount` | `eventbrite.getDiscount()` | `--discount-id` | 0 | Retrieve a discount by its ID from Eventbrite |
| `get-display-settings` | `eventbrite.getDisplaySettings()` | `--event-id` | 0 | Retrieve display settings for a specific Eventbrite event |
| `get-event` ·common | `eventbrite.getEvent()` | `--event-id` | 1 | Retrieve detailed information for a specific Eventbrite event by ID |
| `get-event-categories` ·common | `eventbrite.getEventCategories()` | — | 1 | Retrieve event categories |
| `get-event-description` | `eventbrite.getEventDescription()` | `--event-id` | 0 | Retrieve the full HTML description for an Eventbrite event |
| `get-event-formats` ·common | `eventbrite.getEventFormats()` | — | 0 | List event formats |
| `get-event-subcategories` ·common | `eventbrite.getEventSubcategories()` | — | 1 | List all event subcategories |
| `get-format` | `eventbrite.getFormat()` | `--format-id` | 0 | Retrieve a format by format ID |
| `get-inventory-tier` | `eventbrite.getInventoryTier()` | `--event-id` `--inventory-tier-id` | 0 | Retrieve an Inventory Tier by ID for an Event |
| `get-me` ·common | `eventbrite.getMe()` | — | 0 | Retrieve the authenticated user's account information |
| `get-media-upload` | `eventbrite.getMediaUpload()` | `--type` | 0 | Retrieve information on a Media image upload |
| `get-organizer` ·common | `eventbrite.getOrganizer()` | `--organizer-id` | 0 | Retrieve an organizer by organizer ID from Eventbrite |
| `get-sales-report` ·common | `eventbrite.getSalesReport()` | `--event-ids` `--organization-id` | 5 | Retrieve a sales report by Event ID or Event status for an organization |
| `get-series` ·common | `eventbrite.getSeries()` | `--series-id` | 0 | Retrieve a parent Event Series by Event Series ID |
| `get-structured-content` ·common | `eventbrite.getStructuredContent()` | `--event-id` | 0 | Retrieve structured content for an Eventbrite event |
| `get-structured-content-edit` | `eventbrite.getStructuredContentEdit()` | `--event-id` | 0 | Retrieve the latest working version of structured content for an event |
| `get-subcategory` | `eventbrite.getSubcategory()` | `--subcategory-id` | 0 | Retrieve a specific subcategory by ID |
| `get-ticket-class` ·common | `eventbrite.getTicketClass()` | `--event-id` `--ticket-class-id` | 0 | Retrieve a specific ticket class by ID for an Eventbrite event |
| `get-ticket-group` | `eventbrite.getTicketGroup()` | `--ticket-group-id` | 0 | Retrieve a ticket group by its ID from Eventbrite |
| `get-tracking-beacon` | `eventbrite.getTrackingBeacon()` | `--tracking-beacon-id` | 0 | Retrieve a tracking beacon by ID from Eventbrite |
| `get-user` ·common | `eventbrite.getUser()` | `--user-id` | 0 | Retrieve information about a user by user ID |
| `get-venue` ·common | `eventbrite.getVenue()` | `--venue-id` | 0 | Retrieve detailed information for a specific venue by venue ID |
| `list-access-codes` ·common | `eventbrite.listAccessCodes()` | `--event-id` | 1 | Retrieve all access codes for an Eventbrite event |
| `list-custom-questions` ·common | `eventbrite.listCustomQuestions()` | `--event-id` | 1 | Retrieve custom questions configured for an Eventbrite event |
| `list-default-questions` | `eventbrite.listDefaultQuestions()` | `--event-id` | 1 | Retrieve default (canned) questions for an Eventbrite event by Event ID |
| `list-event-attendees` ·common | `eventbrite.listEventAttendees()` | `--event-id` | 3 | Retrieve the list of attendees for an Eventbrite event |
| `list-event-orders` ·common | `eventbrite.listEventOrders()` | `--event-id` | 7 | List orders for a specific Eventbrite event |
| `list-inventory-tiers` | `eventbrite.listInventoryTiers()` | `--event-id` | 1 | Retrieve inventory tiers for an Eventbrite event |
| `list-org-attendees` ·common | `eventbrite.listOrgAttendees()` | `--organization-id` | 3 | List attendees across all events owned by an Eventbrite organization |
| `list-org-organizers` ·common | `eventbrite.listOrgOrganizers()` | `--organization-id` | 1 | List organizers belonging to a specific Eventbrite organization |
| `list-org-venues` ·common | `eventbrite.listOrgVenues()` | `--organization-id` | 1 | List venues owned by a specific Eventbrite organization |
| `list-organization-events` ·common | `eventbrite.listOrganizationEvents()` | `--organization-id` | 6 | List events owned by a specific Eventbrite organization |
| `list-organization-members` ·common | `eventbrite.listOrganizationMembers()` | `--organization-id` | 1 | List members of an Eventbrite organization by organization ID |
| `list-organization-orders` ·common | `eventbrite.listOrganizationOrders()` | `--organization-id` | 4 | List orders placed for events owned by a specific Eventbrite organization |
| `list-organization-roles` | `eventbrite.listOrganizationRoles()` | `--organization-id` | 0 | List roles within a specific Eventbrite organization by organization ID |
| `list-organization-webhooks` | `eventbrite.listOrganizationWebhooks()` | `--organization-id` | 1 | List all webhooks configured for a specific Eventbrite organization |
| `list-pricing` | `eventbrite.listPricing()` | `--country` `--currency` | 0 | List available pricing fee rates for a specific currency and country |
| `list-series-events` ·common | `eventbrite.listSeriesEvents()` | `--series-id` | 1 | List all events in an Eventbrite event series by series ID |
| `list-ticket-classes` ·common | `eventbrite.listTicketClasses()` | `--event-id` | 1 | List ticket classes for a specific Eventbrite event by event ID |
| `list-ticket-classes-for-sale` ·common | `eventbrite.listTicketClassesForSale()` | `--event-id` | 1 | List ticket classes available for sale for a specific Eventbrite event |
| `list-ticket-groups` | `eventbrite.listTicketGroups()` | `--organization-id` | 1 | List ticket groups for a specific Eventbrite organization |
| `list-tracking-beacons` ·common | `eventbrite.listTrackingBeacons()` | `--organization-id` | 1 | List tracking beacons for an Eventbrite organization by organization ID |
| `list-user-orders` ·common | `eventbrite.listUserOrders()` | `--user-id` | 1 | List orders for a specific Eventbrite user |
| `list-user-organizations` ·common | `eventbrite.listUserOrganizations()` | — | 1 | List organizations the authenticated user belongs to |
| `list-user-orgs` | `eventbrite.listUserOrgs()` | `--user-id` | 1 | List organizations by user ID |
| `list-venue-events` ·common | `eventbrite.listVenueEvents()` | `--venue-id` | 1 | List all events at a specific Eventbrite venue by venue ID |
| `publish-event` | `eventbrite.publishEvent()` | `--event-id` | 0 | Publish an Eventbrite event |
| `retrieve-media` | `eventbrite.retrieveMedia()` | `--media-id` | 2 | Retrieve media information by ID |
| `search-discounts-by-organization` ·common | `eventbrite.searchDiscountsByOrganization()` | `--event-id` `--organization-id` `--scope` | 1 | Search and list discounts by organization ID |
| `set-structured-content` ·common | `eventbrite.setStructuredContent()` | `--event-id` `--version-number` | 3 | Set structured content for an Eventbrite event by version |
| `unpublish-event` | `eventbrite.unpublishEvent()` | `--event-id` | 0 | Unpublish an Eventbrite event |
| `update-access-code` ·common | `eventbrite.updateAccessCode()` | `--access-code-id` `--code` `--event-id` `--ticket-ids` | 3 | Update an existing access code for an Eventbrite event |
| `update-assortment` | `eventbrite.updateAssortment()` | `--organization-id` `--plan` | 0 | Update the assortment plan for a specific organization |
| `update-capacity-tier` | `eventbrite.updateCapacityTier()` | `--capacity-tier` `--event-id` | 0 | Update the capacity tier for an Eventbrite event |
| `update-default-question` | `eventbrite.updateDefaultQuestion()` | `--event-id` `--question-id` | 1 | Update a default (canned) question for an Eventbrite event |
| `update-discount` | `eventbrite.updateDiscount()` | `--discount-id` | 13 | Update a discount by its ID in Eventbrite |
| `update-display-settings` | `eventbrite.updateDisplaySettings()` | `--display-settings` `--event-id` | 0 | Update display settings for a specific Eventbrite event |
| `update-event` | `eventbrite.updateEvent()` | `--event` `--event-id` | 0 | Update an Eventbrite event by ID |
| `update-inventory-tier` | `eventbrite.updateInventoryTier()` | `--event-id` `--inventory-tier` `--inventory-tier-id` | 0 | Update an existing Inventory Tier by ID for an Event |
| `update-organizer` | `eventbrite.updateOrganizer()` | `--organizer` `--organizer-id` | 0 | Update an Eventbrite organizer by ID |
| `update-ticket-buyer-settings` | `eventbrite.updateTicketBuyerSettings()` | `--event-id` `--ticket-buyer-settings` | 0 | Update ticket buyer settings for an Eventbrite event |
| `update-ticket-class` ·common | `eventbrite.updateTicketClass()` | `--event-id` `--ticket-class` `--ticket-class-id` | 0 | Update a ticket class for an Eventbrite event |
| `update-ticket-group` | `eventbrite.updateTicketGroup()` | `--ticket-group` `--ticket-group-id` | 0 | Update a ticket group by its ID in Eventbrite |
| `update-venue` | `eventbrite.updateVenue()` | `--venue` `--venue-id` | 0 | Update a venue's details by venue ID |

## Docs

- [run CLI](https://docs.boxd.sh/cli/run): Call connected integrations from the shell, connect new ones, and run automations.
- [Quickstart](https://docs.boxd.sh/guides/integrations/quickstart): Connect an integration, call it from the shell, and turn a script into an automation.
- [Connections](https://docs.boxd.sh/guides/integrations/connections): Connect an account once, for yourself or for your whole organization.
- [Scripts](https://docs.boxd.sh/guides/automations/scripts): Typed integrations, triggers, schedules and state in a .run.ts file.
- [Jobs](https://docs.boxd.sh/guides/automations/jobs): How a script becomes a background job: states, retries, sleep and wake.
- [Beyond the catalog](https://docs.boxd.sh/guides/automations/beyond-the-catalog): Reach your own APIs, databases and cloud accounts from a script.