API
The 42min Public REST API, covering authentication (PATs, OAuth 2.1 + PKCE), scopes, rate limits, idempotency, and a reference for every /v1 endpoint.
- API overviewThe 42min Public REST API, with its base URL, OpenAPI spec, versioning, JSON envelopes, pagination and errors, and what you can build with it.
- AuthenticationAuthenticate to the 42min API with a personal access token or an OAuth 2.1 + PKCE token, including the full authorize, consent, token and refresh flow.
- ScopesThe full list of OAuth and PAT scopes, what each one grants, the alias expansions, and how scope enforcement works.
- Rate limitsPer-minute request quotas on the 42min API, the X-RateLimit-* headers every response carries, per-endpoint overrides, and how to back off on a 429.
- IdempotencyHow the Idempotency-Key header makes write requests safe to retry, with fingerprinting, replay window, and conflict handling.
- Optimistic locking (ETag / If-Match)How PATCH on /v1/bookings uses ETag and If-Match for optimistic concurrency control, giving read-modify-write without races.
- ErrorsThe JSON error envelope every failed 42min API call returns, the error code taxonomy, what each HTTP status means, and how a client should handle it.
- DiscoveryThe .well-known endpoints that publish the 42min OAuth authorization server and protected resource metadata, and why a client should read them first.
- GET /v1/_pingA cheap probe of auth, scope and identity that confirms your token reaches the 42min API and reports the user and organization it belongs to.
- GET /v1/meGET /v1/me returns the profile of the user a 42min API token authenticates. Covers the headers, query parameters, response shape, a curl example and errors.
- /v1/event-typesList and read the event types in the authenticated 42min account, by ID or by slug, with the GET /v1/event-types endpoints and their responses.
- /v1/slotsList available slots for an event type over a window, and check whether a specific slot is bookable right now.
- /v1/bookingsList, read, create, cancel, reschedule and patch bookings over the 42min API. Every write needs an Idempotency-Key, and PATCH also needs an If-Match ETag.
- /v1/seriesList, read, create and manage recurring meeting series over the API. Pause, resume, end, edit the pattern or change the host, with the write rules of bookings.
- /v1/webhooksManage webhook subscriptions over the 42min API. Create, edit and delete them, rotate the signing secret, send a test, and read recent deliveries.