- The token goes in the
s_tokenheader. Create it in Sympla under Minha Conta > Integrações > Chave de acesso da API. With no token stored, Corsair raisesAuthMissingErrorbefore 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_cursorback ascursoruntil it is empty.page_sizegoes up to 200 (500 for participants). - Ids.
event_idis the event id hash fromevents.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,toand returned dates are local totimezone(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.”
- 15 typed API operations
- 1 synced entity (
events) for fast.search()/.list()
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Sympla API key before the first call: More: API Key
pnpm corsair setup --plugin=sympla --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.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 eventQuery synced data
Synced entities supporttenant.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.