Developer Docs
Build with Internal Newsletter
A REST API and webhook ingest endpoint to automate your internal newsletter from scripts, scheduled jobs, Zapier, or Make.
Quickstart
Get your first API call running in under 5 minutes.
API Reference
Full REST API docs — newsletters, blocks, templates, events.
Webhooks
Push content into your library from any tool via the ingest endpoint.
Getting Started
Introduction to the Internal Newsletter API
Overview of the Internal Newsletter API for automating employee newsletters. REST endpoints, webhooks, and AI-powered content generation.
Quickstart — Your First API Call
Create your first internal newsletter programmatically in under 5 minutes. Generate an API key, create content blocks, and assemble a newsletter.
Authentication & API Keys
How to authenticate with the Internal Newsletter API. API key generation, scopes (read, write, send_preview), security best practices, and rate limits.
API Reference
API Overview
Complete REST API reference for Internal Newsletter. Endpoints for newsletters, content blocks, templates, events. JSON responses, pagination, and error handling.
Newsletters API
API reference for managing newsletters. Create drafts, add content blocks, update status, render previews, and send test emails programmatically.
Content Blocks API
API reference for content blocks. Create typed newsletter sections (CEO updates, team spotlights, event announcements), use AI drafting, and manage content status.
Newsletter Blocks API
API reference for composing newsletters. Add content blocks to newsletters, remove them, and reorder them programmatically.
Templates API
API reference for newsletter templates. List available templates, get details, and use template slugs when creating newsletters.
Events API
API reference for events. List upcoming company events, awareness days, and cultural dates. Get suggested newsletter content for each event.
Team API
API reference for the team endpoint. Get team details, brand colour, newsletter cadence, current plan, and usage metrics.
Webhooks & Content Ingestion
Ingest content from external sources into Internal Newsletter via webhooks. Push updates from Slack, Notion, BambooHR, and other tools as newsletter content blocks.
Integrations
MCP Server — Connect Claude, ChatGPT and AI Agents
Connect Claude, Claude Code, ChatGPT or any MCP client to Internal Newsletter at https://internalnewsletter.com/mcp. Five tools to plan, draft, export and measure your internal newsletter, authenticated with your API key.
Zapier & Make Integration
Connect Internal Newsletter to 5,000+ apps with Zapier and Make. Automate content collection from Slack, Google Forms, Notion, and HRIS tools.
Using AI Agents for Newsletter Automation
How to use AI agents like Claude, GPT, and custom LLM workflows to automate internal newsletter creation, content drafting, and distribution.
Developer Guides
Guide: Automated Newsletter Assembly
Step-by-step guide to building an automated newsletter assembly pipeline. Pull content, draft missing sections with AI, assemble, preview, and distribute.
Guide: Content Ingestion Pipeline
Build a content ingestion pipeline that automatically collects newsletter content from Slack, Notion, Google Docs, HRIS, and GitHub into your content library.
Guide: Building Custom Integrations
Guide to building custom integrations with the Internal Newsletter API. Authentication, error handling, pagination, and code examples in Python, JavaScript, and Ruby.
Ready to automate your internal newsletter?
Create an account, generate an API key, and start building in minutes.
Get started free