Skip to main content
Use Passcreator through Corsair: one client, typed API calls, and incoming webhooks. Authenticate with the API key from the Passcreator app (Account > API); the plugin sends it as the raw value of the Authorization header, without a Bearer prefix, exactly as the API expects. Pass identifiers accept the pass UID, the barcode value or a user-provided ID. Pass properties are keyed by the template’s property names or property IDs; call templates.fields to list what a template expects before creating or updating passes. Marking a pass voided is done with passes.update and the voided flag. API v3 (query language, bulk operations), pass bundles and the validate-passes endpoints are documented by Passcreator but not part of this plugin. Webhook subscriptions are managed through the API (webhooks.subscribe). Deliveries carry a signedData string and a hex ECDSA signature over it; verify them with the PEM public key from webhooks.getPublicKey (store it with keys.set_webhook_signature or set it as the plugin’s webhookSecret). That key is the same for every Passcreator account, so webhooks.subscribe also adds a corsair_token query parameter to the target URL, derived from the account’s API key; the handler refuses deliveries whose URL lacks this account’s token. Create subscriptions through webhooks.subscribe (not the Passcreator dashboard), and create them again after rotating the API key. Every operation is described in the official docs: https://developer.passcreator.com/en What you get:
  • 21 typed API operations
  • 1 incoming webhook event types

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

Read a pass
Create a pass from a template
See the full list on the API page.

Webhooks

This plugin registers 1 webhook event type. Configure the provider to POST to your Corsair HTTP handler, then use webhookHooks on the plugin factory. See Webhooks for every event path and payload shape, and Webhooks concept for routing.

What’s next

API reference

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

Webhooks

Event paths, payloads, and webhookHooks examples.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.