Webhooks & API Keys

StageTick lets Pro and Enterprise users integrate with external services via webhooks and a REST API. Manage webhooks from Organisation Settings and API keys from each room's menu.

Pro+ feature: Webhooks and API keys are available on the Pro and Enterprise plans. See Plans & Limits for details.

Webhooks

Webhooks let StageTick push real-time event notifications to your server. When something happens in a room, StageTick sends an HTTP POST request to the URL you configure.

Supported events

Event Description
room.on_air Fired when a room goes on air (playback starts)
room.off_air Fired when a room goes off air (playback stops)
timer.started Fired when a timer starts running
timer.finished Fired when a timer reaches zero

Managing webhooks

To create, view, or delete webhooks, go to Organisation Settings in the account menu.

  1. Open the account menu and select Organisation Settings.
  2. Scroll to the Webhooks section.
  3. Click Add Webhook, enter the target URL, and select the events you want to subscribe to.
  4. After creation, the signing secret is displayed once. Copy and store it securely — you will not be able to see it again.
Important: The signing secret is shown only once when you create the webhook. Use it to verify that incoming requests are genuinely from StageTick.

Limits

  • Pro: up to 5 webhooks per organisation
  • Enterprise: up to 20 webhooks per organisation

API Keys

API keys let you access room data programmatically via the StageTick REST API. Each key is scoped to a single room and has a permission level.

Scopes

  • read — read-only access to room data (timers, transport state, messages, questions)
  • readwrite — full access to read and modify room data

Managing API keys

To create, view, or revoke API keys, open the room menu for the room you want to integrate with.

  1. Open a room and click the room menu (three-dot icon or room settings).
  2. Select API Keys.
  3. Click Create API Key, choose a scope (read or readwrite), and optionally add a label.
  4. The key is displayed once after creation. Copy and store it securely — you will not be able to see it again.
  5. To revoke a key, click the delete button next to it. Revoked keys stop working immediately.
Important: The API key value is shown only once when you create it. If you lose it, revoke the old key and create a new one.

Limits

  • Pro: up to 5 API keys per room
  • Enterprise: up to 20 API keys per room