Docs Home Product Docs

Lightmeter APIs

Public APIs and developer documentation

Campaigns API

Create campaigns with automated sequences, add leads incrementally, and manage sending schedules with A/B testing support.

POST /api/v1/campaigns/submit
POST /api/v1/campaigns/{campaign_id}/leads
GET /api/v1/campaigns
GET /api/v1/campaigns/{campaign_id}
View Documentation

Analytics API

Beta

Retrieve campaign performance metrics, including date-grained trends, sequence-email performance, lead outcomes, replies, end-autoreplies, and bounces.

GET /api/v1/analytics/overview
GET /api/v1/campaigns/{campaign_id}/analytics
GET /api/v1/campaigns/{campaign_id}/analytics/timeseries
GET /api/v1/campaigns/{campaign_id}/analytics/sequence
GET /api/v1/campaigns/{campaign_id}/analytics/leads
GET /api/v1/campaigns/{campaign_id}/leads/{lead_id}/activity
View Documentation

Lightmeter MCP

Beta

Connect MCP-compatible tools to Beam with OAuth sign-in, then list campaigns, retrieve analytics, submit campaigns, and add leads.

MCP https://mcp.lightmeter.io/mcp
View Setup

Getting Started

All API requests should be made to our base URL:

https://beam.lightmeter.io

Authentication

All API endpoints require authentication using Organization API Keys. Include your API key in the Authorization header:

Authorization: Bearer your_api_key_here

Note: If you haven't already received API access, please request it from your account manager.

API keys are scoped to your organization and provide access to all endpoints your account has permissions for.