Overview

• Ids are strings. Eventbrite types every id as a string ("2000937221092"), and the plugin accepts a number too but always sends and returns the string.
• name is not the same type everywhere. events.create and events.update need { html } for the event name, description and question text; ticketClasses.create, venues.create and discount code take plain strings. The schema enforces each, so the mistake fails before a request is spent. summary is always plain text, capped at 140 characters.
• summary and description are mutually exclusive, as are listed with invite_only or password, and online_event with venue_id. Eventbrite answers 400 ARGUMENTS_ERROR for each; the schemas reject them first.
• Writes that need a clean event. events.publish needs a name, an organizer, at least one ticket and valid payment options. events.delete and events.cancel are refused while any order is pending or completed, and ticketClasses.delete is refused once a ticket has sold, or for the last ticket while the event is live.
• Expansions. Event reads take expand (venue, organizer, category, format, logo, ticket_availability, …), which inlines related objects instead of making a second call. Each one slows the response slightly.
• Paging is a continuation token. Every list returns pagination.continuation with has_more_items; pass the token back as continuation to walk the list. page_size defaults to 50 and Eventbrite caps it at 300 — a larger value is silently answered with 300, which is why the schema rejects anything above 300.
• Rate limits are 2,000 calls an hour and 48,000 a day per token, with events.create, events.copy and events.publish limited to 200 an hour. A 429 carries HIT_RATE_LIMIT and no Retry-After header, so the plugin retries with a fixed 60-second wait.
• A webhook delivery is a notification, not the object. The POST body holds only api_url (where the changed object lives on the v3 API) and config.action (what fired). Eventbrite does not sign deliveries and does not allow a custom header on the subscription, so the receiving URL must be private; the plugin exposes the notification, and reading the object back is a normal authenticated call.
• Orders and attendees are private. They need a token whose user is an organizer of the event; a bare private token for a user with no organization gets 403 on those routes. venues.list answers 500 for an organization with no venues instead of an empty page.

• 46 typed API operations
• 1 incoming webhook event types

​

Setup

npm install corsair @corsair-dev/eventbrite better-sqlite3
npm install --save-dev @types/better-sqlite3

yarn add corsair @corsair-dev/eventbrite better-sqlite3
yarn add --dev @types/better-sqlite3

pnpm install corsair @corsair-dev/eventbrite better-sqlite3
pnpm install --save-dev @types/better-sqlite3

bun add corsair @corsair-dev/eventbrite better-sqlite3
bun add --dev @types/better-sqlite3

import Database from 'better-sqlite3';
import { createCorsair } from 'corsair';
import { eventbrite } from '@corsair-dev/eventbrite';

export const corsair = createCorsair({
	plugins: [
		eventbrite(),
	],
	database: new Database('corsair.db'),
	kek: process.env.CORSAIR_KEK!,
	multiTenancy: true,
	hub: {
		projectApiKey: process.env.CORSAIR_API_KEY!,
		signingSecret: process.env.CORSAIR_SIGNING_SECRET!,
	},
});

eventbrite()

const { connectUrl } = await corsair.manage.connect.createLink({
	plugin: 'eventbrite',
	tenantId: 'acme',
});
// redirect the user's browser to connectUrl

​

Example API calls

const tenant = corsair.withTenant('acme');
await tenant.eventbrite.api.events.listByOrganization({ organization_id: '154830740213', name_filter: 'Launch' });

const tenant = corsair.withTenant('acme');
await tenant.eventbrite.api.events.create({
	organization_id: '154830740213',
	event: {
		name: { html: 'Product launch night' },
		start: { timezone: 'America/New_York', utc: '2027-06-01T14:00:00Z' },
		end: { timezone: 'America/New_York', utc: '2027-06-01T18:00:00Z' },
		currency: 'USD',
		listed: false,
	},
});

​

Webhooks

eventbrite({
    webhookHooks: {
        notifications: {
            delivery: {
                after: async (ctx, result) => {
                    if (result.data?.action === 'order.placed') console.log('order at', result.data.api_url);
                }
            },
        },
    },
})

​

What’s next