If you run classes or events with your own website or booking system, Gerany can work alongside it instead of making you copy everything over by hand.
The easiest way needs no code at all. If your scheduling tool can publish a public calendar link (ICS) — Google Calendar, Apple Calendar and most booking software can — paste it under Settings → Connected calendars. Your upcoming classes become experiences automatically and refresh every hour.
API keys, for anything more. In Settings → API keys, create a key and Gerany hands it to you once. Save it somewhere safe like a password manager; if you lose it, revoke it and make a new one. Treat it like a password — anyone holding it can act as you.
What a key can and cannot do. A key works only on experiences: creating and updating them, selling tickets, checking people in at the door, and connecting calendars. It can never read your messages, move your money, or change your profile — and you can revoke it at any moment.
Building the integration. The complete technical reference — every endpoint, example requests, and what each error means — is at gerany.com/integration-api.md. It is also written to be handed to an AI coding assistant: point one at that page and it can build the integration for you. The page includes ready-made instructions for the three usual jobs — syncing your schedule, putting your experiences on your own website, and building a check-in screen for the door.
Stuck? Write to [email protected] and tell us what you're trying to connect.
01
Connect a calendar — no code needed
1. In your scheduling tool (Google Calendar, Apple Calendar, most booking software), copy the public ICS link.
2. In Gerany: Settings → Connected calendars → paste the link.
3. Choose a default venue for imported events.
4. Done — upcoming events become experiences automatically and refresh hourly.
02
Create an API key
1. Open Settings → API keys and tap create.
2. The key is shown once — copy it into a password manager immediately.
3. Treat it like a password: anyone holding it can act as you. Lost it? Revoke and create a new one — revocation is instant.
4. Keys work only on the experiences surface: creating and updating experiences, tickets, door check-in, calendars. A key can never read messages, move money, or touch your profile.
03
Build with the API
1. The full technical reference lives at gerany.com/integration-api.md — every endpoint, example requests, and every error explained.
2. It's written to be handed to an AI coding assistant: point one at that page and it can build your integration for you.
3. Ready-made instructions are included for the three usual jobs: syncing your schedule, embedding your experiences on your own website, and building a door check-in screen.