API Overview

The Keep'em API is a RESTful API at https://api.keepem.io/v1 that provides programmatic access to the Keep'em platform. Manage events, viewers, media, analytics, AI chat, and more.

New to the Keep'em API? Start with Authentication for API key setup, then see Getting Started for request conventions, error handling, and pagination.

Prerequisites

To use the Keep'em API, you'll need:

A Keep'em dashboard account
An API key (created in Settings > API Keys)

Authentication

All management requests must include your API key in the X-API-Key header:

Header	Value	Required
`X-API-Key`	Your API key from the dashboard	Yes
`Content-Type`	`application/json`	Yes (for request bodies)

Example request

curl https://api.keepem.io/v1/events \
  -H "X-API-Key: sk_live_your_secret_key"

For details on key types (sk_ vs pk_), see Authentication.

Available APIs

Register for Event: Register a viewer for an event (POST /v1/events/{eventID}/register)
Identify Viewer: Identify a viewer with custom attributes (POST /v1/events/{eventID}/identify)

Client SDK

The official TypeScript SDK handles authentication, request formatting, and type safety:

npm install @keepem/sdk

Usage

import { createClient } from '@keepem/sdk';

const client = createClient({
  baseUrl: 'https://api.keepem.io',
  apiKey: 'sk_live_your_secret_key',
});

const events = await client.events.list();

Basic example

Create an event

curl -X POST https://api.keepem.io/v1/events \
  -H "X-API-Key: sk_live_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Demo Q1",
    "description": "Quarterly product walkthrough"
  }'

Response

{
  "id": "evt_abc123",
  "name": "Product Demo Q1",
  "description": "Quarterly product walkthrough",
  "status": "draft",
  "createdAt": "2026-03-05T10:00:00Z"
}