eventbrite（eventbrite 开发）

Eventbrite

Access the Eventbrite API with managed OAuth authentication. Manage events, venues, ticket classes, orders, attendees, and more.

Quick Start

# Get current user
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/eventbrite/v3/users/me/')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Base URL

https://api.maton.ai/eventbrite/{native-api-path}

Maton proxies requests to www.eventbriteapi.com and automatically injects your OAuth token.

Authentication

All requests require the Maton API key in the Authorization header:

Authorization: Bearer $MATON_API_KEY

Environment Variable: Set your API key as MATON_API_KEY:

export MATON_API_KEY="YOUR_API_KEY"

Getting Your API Key

1. Sign in or create an account at maton.ai
2. Go to maton.ai/settings
3. Copy your API key

Connection Management

Manage your Eventbrite OAuth connections at https://api.maton.ai.

List Connections

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections?app=eventbrite&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create Connection

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'eventbrite'}).encode()
req = urllib.request.Request('https://api.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Get Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "connection": {
    "connection_id": "{connection_id}",
    "status": "ACTIVE",
    "creation_time": "2026-02-07T09:11:20.516013Z",
    "last_updated_time": "2026-02-07T09:14:35.273822Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "eventbrite",
    "metadata": {}
  }
}

Open the returned url in a browser to complete OAuth authorization.

Delete Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Specifying Connection

If you have multiple Eventbrite connections, specify which one to use with the Maton-Connection header:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/eventbrite/v3/users/me/')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '{connection_id}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

If you have multiple connections, always include this header to ensure requests go to the intended account.

Security & Permissions

• Access is scoped to events, venues, ticket classes, orders, and attendees within the connected Eventbrite account.
• All write operations require explicit user approval. Before executing any create, update, or delete call, confirm the target resource and intended effect with the user.

API Reference

User Operations

Get Current User

GET /eventbrite/v3/users/me/

Response:

{
  "emails": [{"email": "user@example.com", "verified": true, "primary": true}],
  "id": "1234567890",
  "name": "John Doe",
  "first_name": "John",
  "last_name": "Doe",
  "is_public": false,
  "image_id": null
}

List User Organizations

GET /eventbrite/v3/users/me/organizations/

List User Orders

GET /eventbrite/v3/users/me/orders/

Organization Operations

List Organization Events

GET /eventbrite/v3/organizations/{organization_id}/events/

Query parameters:

• status - Filter by status: draft, live, started, ended, completed, canceled
• order_by - Sort order: start_asc, start_desc, created_asc, created_desc
• time_filter - Filter by time: current_future, past

List Organization Venues

GET /eventbrite/v3/organizations/{organization_id}/venues/

Create Venue

POST /eventbrite/v3/organizations/{organization_id}/venues/
Content-Type: application/json

{
  "venue": {
    "name": "Conference Center",
    "address": {
      "address_1": "123 Main St",
      "city": "San Francisco",
      "region": "CA",
      "postal_code": "94105",
      "country": "US"
    }
  }
}

Event Operations

Get Event

GET /eventbrite/v3/events/{event_id}/

Create Event

Events must be created under an organization:

POST /eventbrite/v3/organizations/{organization_id}/events/
Content-Type: application/json

{
  "event": {
    "name": {"html": "My Event"},
    "description": {"html": "<p>Event description</p>"},
    "start": {
      "timezone": "America/Los_Angeles",
      "utc": "2026-03-01T19:00:00Z"
    },
    "end": {
      "timezone": "America/Los_Angeles",
      "utc": "2026-03-01T22:00:00Z"
    },
    "currency": "USD",
    "online_event": false,
    "listed": true,
    "shareable": true,
    "capacity": 100,
    "category_id": "103",
    "format_id": "1"
  }
}

Update Event

POST /eventbrite/v3/events/{event_id}/
Content-Type: application/json

{
  "event": {
    "name": {"html": "Updated Event Name"},
    "capacity": 200
  }
}

Publish Event

POST /eventbrite/v3/events/{event_id}/publish/

Unpublish Event

POST /eventbrite/v3/events/{event_id}/unpublish/

Cancel Event

POST /eventbrite/v3/events/{event_id}/cancel/

Delete Event

DELETE /eventbrite/v3/events/{event_id}/

Ticket Class Operations

List Ticket Classes

GET /eventbrite/v3/events/{event_id}/ticket_classes/

Create Ticket Class

POST /eventbrite/v3/events/{event_id}/ticket_classes/
Content-Type: application/json

{
  "ticket_class": {
    "name": "General Admission",
    "description": "Standard entry ticket",
    "quantity_total": 100,
    "cost": "USD,2500",
    "sales_start": "2026-01-01T00:00:00Z",
    "sales_end": "2026-02-28T23:59:59Z",
    "minimum_quantity": 1,
    "maximum_quantity": 10
  }
}

For free tickets, omit the cost field or set free: true.

Update Ticket Class

POST /eventbrite/v3/events/{event_id}/ticket_classes/{ticket_class_id}/
Content-Type: application/json

{
  "ticket_class": {
    "quantity_total": 150
  }
}

Delete Ticket Class

DELETE /eventbrite/v3/events/{event_id}/ticket_classes/{ticket_class_id}/

Attendee Operations

List Event Attendees

GET /eventbrite/v3/events/{event_id}/attendees/

Query parameters:

• status - Filter by status: attending, not_attending, unpaid
• changed_since - ISO 8601 timestamp to get attendees changed after

Get Attendee

GET /eventbrite/v3/events/{event_id}/attendees/{attendee_id}/

Order Operations

List Event Orders

GET /eventbrite/v3/events/{event_id}/orders/

Query parameters:

• status - Filter by status: active, inactive, all
• changed_since - ISO 8601 timestamp

Get Order

GET /eventbrite/v3/orders/{order_id}/

Venue Operations

Get Venue

GET /eventbrite/v3/venues/{venue_id}/

Update Venue

POST /eventbrite/v3/venues/{venue_id}/
Content-Type: application/json

{
  "venue": {
    "name": "Updated Venue Name"
  }
}

Reference Data

List Categories

GET /eventbrite/v3/categories/

Response:

{
  "locale": "en_US",
  "pagination": {"object_count": 21, "page_number": 1, "page_size": 50},
  "categories": [
    {"id": "103", "name": "Music", "short_name": "Music"},
    {"id": "101", "name": "Business & Professional", "short_name": "Business"},
    {"id": "110", "name": "Food & Drink", "short_name": "Food & Drink"}
  ]
}

Get Category

GET /eventbrite/v3/categories/{category_id}/

List Subcategories

GET /eventbrite/v3/subcategories/

List Formats

GET /eventbrite/v3/formats/

Common formats:

• 1 - Conference
• 2 - Seminar or Talk
• 5 - Festival or Fair
• 6 - Concert or Performance
• 9 - Class, Training, or Workshop
• 10 - Meeting or Networking Event
• 11 - Party or Social Gathering

List Countries

GET /eventbrite/v3/system/countries/

List Regions

GET /eventbrite/v3/system/regions/

Pagination

Eventbrite uses a combination of page-based and continuation-based pagination:

GET /eventbrite/v3/organizations/{org_id}/events/?page_size=50

Response:

{
  "pagination": {
    "object_count": 150,
    "page_number": 1,
    "page_size": 50,
    "page_count": 3,
    "has_more_items": true,
    "continuation": "eyJwYWdlIjogMn0"
  },
  "events": [...]
}

For subsequent pages, use the continuation token:

GET /eventbrite/v3/organizations/{org_id}/events/?continuation=eyJwYWdlIjogMn0

Expansions

Include related data by using the expand parameter:

GET /eventbrite/v3/events/{event_id}/?expand=venue,ticket_classes,category

Common expansions:

• venue - Include venue details
• ticket_classes - Include ticket information
• category - Include category details
• subcategory - Include subcategory details
• format - Include format details
• organizer - Include organizer information

Code Examples

JavaScript

const response = await fetch(
  'https://api.maton.ai/eventbrite/v3/users/me/',
  {
    headers: {
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    }
  }
);
const user = await response.json();

Python

import os
import requests

response = requests.get(
    'https://api.maton.ai/eventbrite/v3/users/me/',
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}
)
user = response.json()

Notes

• All endpoint paths should end with a trailing slash (/)
• Event creation requires an organization - use organization-based endpoints
• Legacy user-based event endpoints are deprecated; use organization equivalents
• Timestamps are in ISO 8601 format (UTC)
• Currency amounts are in minor units (cents) - e.g., "USD,2500" = $25.00
• Rate limit: 1,000 calls per hour, 48,000 calls per day
• Event Search API is no longer publicly available (deprecated February 2020)
• IMPORTANT: When using curl commands, use curl -g when URLs contain brackets to disable glob parsing
• IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments

Error Handling

Common Errors

NOT_AUTHORIZED with legacy user endpoints:

{"status_code": 403, "error": "NOT_AUTHORIZED", "error_description": "This user is not able to use legacy user endpoints, please use the organization equivalent."}

Solution: Use /organizations/{org_id}/events/ instead of /users/me/owned_events/

Troubleshooting: API Key Issues

1. Check that the MATON_API_KEY environment variable is set:

echo $MATON_API_KEY

1. Verify the API key is valid by listing connections:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Troubleshooting: Invalid App Name

1. Ensure your URL path starts with eventbrite. For example:

• Correct: https://api.maton.ai/eventbrite/v3/users/me/
• Incorrect: https://api.maton.ai/v3/users/me/

Resources

• Eventbrite API Documentation
• API Basics
• API Explorer
• Maton Community
• Maton Support