● Greenroom

API Reference

REST API for your event data. Create tokens in Admin → Settings → API Tokens.

Authentication

Pass your token as a Bearer token. Tokens are scoped to one event.

curl https://greenroomplanner.com/api/v1/sessions \
  -H "Authorization: Bearer grk_your_token_here"

Endpoints

GET/api/v1/sessions

Accepted & confirmed sessions with schedule, room, and speakers.

Query params: page, page_size (max 100)

GET/api/v1/submissions

All submissions including custom-field answers.

Query params: page, page_size, status (pending|accepted|...), q (title search)

GET/api/v1/speakers

Speaker/contact profiles with bios, headshots, and links.

Query params: page, page_size

Pagination

Default page size is 25, maximum 100. Responses include pagination.has_more — increment page to fetch the next batch.

Webhooks

Register webhook URLs in Settings. Greenroom POSTs JSON on submission.created and submission.status_changed, signed with X-Greenroom-Signature: sha256=SHA256(secret.body).

{
  "type": "submission.status_changed",
  "created_at": "2026-08-09T12:00:00.000Z",
  "data": {
    "id": "…", "code": "SESS-3",
    "title": "MCP Servers at Scale",
    "previous_status": "pending", "status": "accepted"
  }
}