Quickstart

Authenticate

1. Get your API keys

In the Zenamu admin, open Settings → General info → API keys, then select Generate API keys. You get two keys at once:

Key	Prefix	Use it for
Public API key	`zen_pub_`	Schedule data, safe in a browser
Secret API key	`zen_live_`	Client data, backend only

The secret key is shown once. Copy it before you close the dialog — Zenamu cannot show it again, only replace it.

Self-service generation needs the Ultimate plan. On a trial, contact Zenamu support and they will issue the keys for you.

Plans and access

Which plan unlocks which endpoints.

2. Send the key

Send the key with the HTTP Bearer authentication scheme on every request:

Authorization: Bearer <your_api_key>

Authentication

Full authentication reference.

Make your first request

The base URL is:

https://api.zenamu.com

Fetch this month’s schedule. dateFrom and dateTo are required:

curl \
  -H "Authorization: Bearer <your_public_api_key>" \
  "https://api.zenamu.com/v1/classes?dateFrom=2026-03-01&dateTo=2026-03-31"

Example response (abridged):

{
  "statusCode": 200,
  "message": "Success",
  "data": [
    {
      "_id": "9b1c4f7a2e6d8035c1a94fb27de60381",
      "eventType": "class",
      "name": "Morning Yoga",
      "start": "2026-03-15T08:00:00Z",
      "localTimeStart": "2026-03-15T09:00:00+01:00",
      "timezone": "Europe/Prague",
      "lecturerIds": ["a05e73c81df946b20c3ea8175f6b4e92"],
      "locationId": "b8419fd7250ce6a3418df90b27ec5a41",
      "isOnline": false,
      "isCanceled": false
    }
  ]
}

Every successful response wraps its payload in data. Classes reference their lecturers and location by ID — fetch /v1/lecturers and /v1/places once, then match the IDs.

Getting started

Authenticate

1. Get your API keys

Plans and access

2. Send the key

Authentication

Make your first request

Next steps

Build a schedule page

API reference

​Authenticate

​1. Get your API keys

Plans and access

​2. Send the key

Authentication

​Make your first request

​Next steps

Build a schedule page

API reference

Authenticate

1. Get your API keys

2. Send the key

Make your first request

Next steps