Skip to main content
Use Sympla through Corsair: one client, typed API calls, local DB sync. Things to know before you call:
  • The token goes in the s_token header. Create it in Sympla under Minha Conta > Integrações > Chave de acesso da API. With no token stored, Corsair raises AuthMissingError before any request; a token Sympla rejects comes back as HTTP 401 (“Invalid Token!”).
  • This is Sympla’s v1.6.0 Public API. Lists page with a cursor: pass pagination.next_cursor back as cursor until it is empty. page_size goes up to 200 (500 for participants).
  • Ids. event_id is the event id hash from events.list. Presentations are an event’s sessions or dates; orders and participants can be read per event, per presentation or per order.
  • Dates use a timezone. from, to and returned dates are local to timezone (Sympla default America/Sao_Paulo). Null fields may be left out of replies.
  • Personal data. Orders and participants include buyer and participant names and emails. Corsair keeps them out of its event log; it stores only event ids and names.
  • Check-ins can’t be undone through the API, so the three check-in operations are destructive. A second check-in of the same ticket answers HTTP 400 “Participant has already checked-in.”
What you get:
  • 15 typed API operations
  • 1 synced entity (events) for fast .search() / .list()

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

List the participants of an event
Check a participant in by ticket number
See the full list on the API page.

Query synced data

Synced entities support tenant.sympla.db.<entity>.search() and .list(): events. See Database for filters and operators.

What’s next

API reference

Every sympla.api.* operation with input and output types.

Database

Synced entities, search filters, and operators.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.