Everything Loopyah's Zapier, Make and n8n apps call. Each app signs in as the organizer and reads the same lists the Loopyah app does.

Base address, over HTTPShttps://api.loopyah.com

OAuth 2.0

Authorization code with PKCE

JSON

Every read answers as { data }

20 a page

Newest first

120 a minute

Per connection, 360 for n8n

Sign-in

How an app connects as the organizer

GET /.well-known/oauth-authorization-server: Lists the sign-in endpoints below. n8n reads it to sign itself up.
POST /register: n8n registers itself here when you click Connect, as an app with no secret.
GET /authorize: OAuth 2.0 authorization code flow. PKCE with S256 is required.
POST /token: Exchanges the code, or renews with the refresh_token grant. Form body with the client ID, and the secret for apps that have one.
POST /revoke: Ends the connection. Make calls it when you delete one.

Tokens

What an app sends once it's connected

Authorization: Bearer: Sent on every read. Access tokens last 1 hour.
refresh_token: Lasts 90 days from its last use. Every renewal returns a new one, so save it each time.

Parameters

Optional on every list

pageParam: Page number from 0, 20 records a page, newest first.
page: Page number from 1, used by the contacts list instead.
creator: An organizer's ID, to read an organizer whose team you're on.
userId: Someone else's public profile on /data/user. Leave it out for your own.

Account

Who's connected and which organizers they can read

GET /data/user: Who signed in. Make names each connection with it.
GET /data/my-teams: The organizer teams you're on and your role on each. Fills the Organizer field.

Trigger lists

One list per trigger, across every event you run

New orders

GET

/data/creator-ticket-orders

Paid and free orders

New check-ins

GET

/data/creator-check-ins

Guests scanned or checked in

New contacts

GET

/data/creator-contacts

Newest added first, paged from 1

New refunds

GET

/data/creator-ticket-refund-intents

Refunds paid back to customers

New point-of-sale sales

GET

/data/creator-pos-transactions

In-person sales taken with Tap to Pay

New reviews

GET

/data/creator-event-reviews

Guests' reviews of your events

New sponsor applications

GET

/data/creator-sponsorship-sponsors

With their package and payment

Paid payouts

GET

/data/creator-paid-payouts

For tickets, point-of-sale sales and sponsorships

Errors and limits

The status codes an app should handle

401: The access token expired or was revoked. Renew it with the refresh token.
400: Loopyah refused the request. The body is a message saying why, such as a team role that can't read it.
403: The connection can't reach that endpoint.
429: Over the connection's limit: 120 requests a minute for Zapier and Make, 360 for n8n.