Skip to main content
The Nowadays REST API lets you build on top of the Nowadays platform from your own systems. Today it exposes your organization’s events — list them, read one in full, create new ones, and update their planning details. More resources (proposals, contracts, and more) are on the way. It is backed by the same service as the dashboard, so an event created or edited through the API is identical to one changed in the UI — the same validation, the same derived fields, the same permissions.

​
Base URL

Every endpoint lives under /v1.

​
Authentication

Requests authenticate with an API key sent in the x-api-key header:
A key is issued to a person within one organization and acts as that person, so it reaches exactly the events its owner can open. See Authentication for the details.

​
What you can do today

  • List events — page through your organization’s events.
  • Get event — fetch a single event’s full detail by id.
  • Create event — add a new event owned by your key’s user.
  • Update event — change an event’s planning details.

​
Versioning & stability

The API is versioned in the URL (/v1). Within a version we only add fields and endpoints — never remove or rename them — so an integration built today keeps working. Breaking changes ship under a new version (e.g. /v2) with the previous version kept available during a deprecation window.

​
Next steps

Quickstart

Make your first request in under a minute.

Authentication

How API keys are scoped and kept safe.

Writing events

The rules the write path enforces.

Errors

Status codes and the error response shape.