Introduction to the Internal Newsletter API

Overview of the Internal Newsletter API for automating employee newsletters. REST endpoints, MCP server, webhooks, and AI-powered content generation.

Internal Newsletter is a platform for building, managing, and distributing company newsletters. The API lets you automate the entire newsletter workflow — from content creation to assembly to distribution — using AI agents, automation tools, or custom code.

What you can build

  • AI-powered newsletter assembly — Let an agent pull content from submissions, events, and drafts, then assemble a complete newsletter automatically
  • Content ingestion pipelines — Push updates from Slack, Notion, your HRIS, or any tool into your newsletter content library via webhooks
  • Scheduled newsletter workflows — Automate your weekly or monthly newsletter on a cron schedule
  • Custom integrations — Connect Internal Newsletter to your existing internal tools

Three ways to integrate

REST API

A versioned JSON API at /api/v1/ for full programmatic control. Create newsletters, manage content blocks, use AI drafting, and render previews.

MCP Server

A Model Context Protocol server that exposes Internal Newsletter as tools and resources for AI agents. Works with Claude Desktop, Cursor, and any MCP-compatible client.

Webhooks

A simple ingest endpoint that accepts content from external sources. Perfect for Zapier, Make, n8n, or direct HTTP calls from your backend.

Core concepts

Concept Description
Team Your organisation in Internal Newsletter. All resources are scoped to a team.
Newsletter A newsletter issue with a subject line, template, and ordered content blocks.
Content Block A piece of newsletter content — a CEO update, team spotlight, event announcement, etc. Has a type, title, and rich text body.
Template An email template that controls the visual design. You pick one per newsletter.
Event A company or cultural event that can have associated content blocks.

Authentication

All API requests require a team-scoped API key. Keys use the Bearer scheme:

Authorization: Bearer inl_your_api_key_here

Generate keys from Team Settings → API Keys in the app, or see the Authentication guide.

Next steps

Next →

Quickstart — Your First API Call