Eventbrite.Net 0.1.3

Eventbrite.Net

A strongly-typed .NET 10 client library for the Eventbrite REST API.
Supports private-token and OAuth 2.0 authorization-code authentication, with built-in DI registration, in-memory token/state storage, and full IntelliSense documentation on every public type.

Requirements

• .NET 10 or later
• An Eventbrite developer account with an API key / OAuth application

Installation

dotnet add package Eventbrite.Net

Configuration

Add an Eventbrite section to appsettings.json (non-secret values only):

{
  "Eventbrite": {
    "API_KEY": "<your-client-id>",
    "REDIRECT_URI": "https://yourapp.com/eventbrite/auth/callback",
    "FrontendRedirectUri": "https://yourapp.com/dashboard",
    "Scopes": []
  }
}

Store secrets with the .NET Secret Manager (never commit them):

dotnet user-secrets set "Eventbrite:CLIENT_SECRET" "<your-client-secret>"
dotnet user-secrets set "Eventbrite:PRIVATE_TOKEN" "<your-private-token>"

All configuration keys

Quick start — private token

Use this mode when your application acts on behalf of a single Eventbrite account using a long-lived private OAuth token.

// Program.cs
builder.Services.AddEventbriteIntegration(builder.Configuration);

// Inject IPrivateAuthenticatedService anywhere in your app
public class MyService(IPrivateAuthenticatedService eventbrite)
{
    public async Task<string?> GetMyNameAsync(CancellationToken ct)
    {
        var user = await eventbrite.GetMyProfileAsync(ct);
        return user?.Name?.Text;
    }
}

Quick start — OAuth 2.0 (authorization-code flow)

Use this mode when users authorize your application with their own Eventbrite accounts.

// Program.cs
builder.Services.AddEventbriteIntegration(builder.Configuration, isExternallyAuthenticated: true);

// ...

// Register the built-in OAuth callback and diagnostic endpoints
app.MapEventbriteEndpoints();

This maps the following Minimal API endpoints:

// Inject IExternalAuthenticatedService anywhere in your app
public class MyService(IExternalAuthenticatedService eventbrite)
{
    public async Task ShowEventsAsync(string orgId, CancellationToken ct)
    {
        var result = await eventbrite.ListEventsByOrganizationAsync(orgId, cancellationToken: ct);
        foreach (var ev in result?.Events ?? [])
            Console.WriteLine(ev.Name?.Text);
    }
}

Pagination helpers

For high-volume list endpoints, you can use built-in IAsyncEnumerable<T> helpers from Eventbrite.Helpers.EventbritePaginationExtensions. These helpers automatically follow continuation tokens and yield individual items.

Available helpers include:

• ListAllEventsByOrganizationAsync
• ListAllAttendeesByEventAsync
• ListAllOrdersByOrganizationAsync
• ListAllOrdersByEventAsync
• ListAllOrdersByUserAsync
• ListAllTicketClassesByEventAsync

await foreach (var ev in eventbrite.ListAllEventsByOrganizationAsync(orgId, pageSize: 50, cancellationToken: ct))
{
    Console.WriteLine(ev.Name?.Text);
}

Low-level paged methods are still available when you need manual cursor control.

Available APIs

Both IPrivateAuthenticatedService and IExternalAuthenticatedService expose the full IEventbriteApiService surface:

Users

Organizations

Events

Attendees

Orders

Ticket Classes

Ticket Groups

Discounts

Categories & Formats

Questions

Webhooks

Venue & Organizer

Structured Content

Inventory & Capacity

Display Settings

Seat Maps

Teams

Pricing

Media / Images

Reports

Text Overrides

Miscellaneous

All methods accept an optional CancellationToken. List methods accept optional continuation and pageSize parameters for cursor-based pagination. Many event/attendee methods accept an expansions array to embed related sub-objects inline.