Credentials and delivery

Developer console.

Create credentials, connect a calendar app, and choose where Greenroom sends change events.

API keys

Server-side access.

A key acts as its owner and inherits that account's role. Store it as a secret, never ship it in browser code, and revoke it when the integration is retired.

Keys are shown once when created.
Revocation takes effect on the next request.
Each account receives 300 requests per minute.

Credentials

API keys

Keys act as your account. Keep them server-side and revoke anything you no longer use.

Connected apps

Consent and change delivery.

OAuth grants calendar-only access with S256 PKCE. Webhooks deliver signed calendar changes to a public HTTPS endpoint.

Sign in as a DJ to register OAuth clients and webhook endpoints. API keys remain available to both DJ and promoter accounts after sign-in.

Debug

Keep the request ID

Every v1 response includes X-Greenroom-Request-Id. Include it when reporting a failed integration.

Retries

Make creates repeat-safe

Send an Idempotency-Key with create requests. Greenroom remembers the result for 24 hours.

Agents

Use the same key for MCP

The MCP server checks the API key on every tool call, so revocation stays immediate.

Connecting to Greenroom

GreenroomDevelopers

Credentials and delivery

Developer console.

Create credentials, connect a calendar app, and choose where Greenroom sends change events.

Quickstart OpenAPI

API keys

Server-side access.

A key acts as its owner and inherits that account's role. Store it as a secret, never ship it in browser code, and revoke it when the integration is retired.

Keys are shown once when created.
Revocation takes effect on the next request.
Each account receives 300 requests per minute.

Credentials

API keys

Keys act as your account. Keep them server-side and revoke anything you no longer use.

Connected apps

Consent and change delivery.

OAuth grants calendar-only access with S256 PKCE. Webhooks deliver signed calendar changes to a public HTTPS endpoint.

Sign in as a DJ to register OAuth clients and webhook endpoints. API keys remain available to both DJ and promoter accounts after sign-in.

Debug

Keep the request ID

Every v1 response includes X-Greenroom-Request-Id. Include it when reporting a failed integration.

Retries

Make creates repeat-safe

Send an Idempotency-Key with create requests. Greenroom remembers the result for 24 hours.

Agents

Use the same key for MCP

The MCP server checks the API key on every tool call, so revocation stays immediate.