Cénacle API

A read-only REST API, included in the Scale plan: your members, events, registrations and leads, in your own tools.

Authentication

All requests must include your API key in the Authorization header.

Authorization: Bearer your_api_key

Create a key in Settings → API access (Scale plan). It is shown only once: keep it somewhere safe. The key only ever goes in this header, never in the URL.

Rate limit

120 requests / minute

Per key. Beyond that, the API answers 429 with a Retry-After header: wait the indicated delay (60 seconds) before retrying.

Pagination

Parameters ?limit= (100 max) and ?offset=. Every response echoes limit and offset, says whether more results remain (has_more) and gives the next page's offset (next_offset, null on the last page).

{ "data": [], "pagination": { "limit": 100, "offset": 0, "has_more": true, "next_offset": 100 } }

Endpoints

GET

/api/v1/members

The club's active members and their subscription (plan, dates, dinners left).

GET

/api/v1/events

The club's events, drafts excluded. ?upcoming=true for upcoming events only.

GET

/api/v1/events/:id/registrations

Registrations for one of the club's events.

GET

/api/v1/leads

Dinner Pipeline leads. ?status= to filter on a pipeline stage.

Need to write to Cénacle?

The API is read-only for now. Tell us what you want to automate: that is what will decide the next routes.