Eventlayer / Start building

TypeScript SDK

Install Eventlayer, configure a client and handle typed API results.

Use the eventlayer package from your server. It provides typed resource methods, result handling, pagination and webhook verification.

Install and initialise

Terminal · project directory
npm install eventlayer

Set EVENTLAYER_KEY in your server environment, then initialise a client:

eventlayer.ts · server only
import { Eventlayer } from "eventlayer";

const eventlayer = new Eventlayer();

For a complete runnable example, issue your first ticket.

Handle typed results

HTTP responses return { data, error, response }. Check error before reading data. Network failures where no HTTP response is received still throw.

get-ticket.ts · server only
const { data: ticket, error } = await eventlayer.tickets.get({
  ticketId: "tkt_your_ticket_id",
});

if (error) {
  console.error(error.code, error.requestId);
} else {
  console.log(ticket.status);
}

Configure the client

eventlayer.ts · creation workflow
import { Eventlayer } from "eventlayer";

const eventlayer = new Eventlayer(undefined, {
  timeout: 10_000,
  maxRetries: 0,
});

Passing undefined keeps the environment key. You can pass a key explicitly as the first argument in runtimes without process.env. Read retries and recovery before enabling retries for writes.

Find the right method

ResourceExample methodCredential
Eventseventlayer.events.create()API key
Attendeeseventlayer.attendees.create()API key
Ticketseventlayer.tickets.create()API key
Check-ineventlayer.tickets.checkIn()API key
Walleteventlayer.tickets.generateAppleWalletPassSignedUrl()API key
Webhook administrationeventlayer.webhookEndpoints.create()Dashboard access token

Methods above identify the resource operations; their required arguments are shown in the guides and API reference. Webhook administration includes endpoint management, delivery inspection and replay. API keys cannot authorize these operations. See authentication for dashboard access tokens.

Keep going

Use pagination to iterate through collections and webhook verification to validate signed events. The package documentation has the SDK’s full configuration and resource details.