MCP · November 9, 2026
Post a newsletter issue from the MCP
create_newsletter_issue saves the HTML. publish_newsletter_issue sends it to confirmed readers. The subscribe page is still a separate call.
create_newsletter opens the public page and returns its link. It does not send an issue. Saving the letter and sending it are two later calls. A sending key is enough for both. Creating or verifying a domain still needs a full-access key. The From address is the one stored on the newsletter.
Save the issue
create_newsletter_issue needs the newsletter id, a name of up to 80 characters, a subject of up to 200 characters, and the HTML. Plain text is optional. When you leave it out, Pigeon derives it from the HTML. {{name}} and {{email}} are filled for each reader when the issue goes out. The saved issue is a draft. Pass scheduled_at as an ISO 8601 time in the future and the status stays scheduled.
Use create_newsletter_issue on newsletter <id>. Name: Sunday notes. Subject: What shipped this week. HTML is a short letter that greets {{name}}. Reply with the issue id. Do not send it yet.
Send it
publish_newsletter_issue takes that newsletter id and the issue id from the save. It sends to confirmed readers. Publishing an issue whose scheduled_at is still in the future returns sent 0 and leaves the status scheduled. The scheduler sends it when that time arrives. Publishing an issue that is already sent is refused.
Use publish_newsletter_issue for newsletter <id> and issue <campaign_id>. Send it to confirmed readers.
One issue of Pigeon notes was posted with these two calls.
Open Pigeon notesThe same calls on the API
POST /api/newsletters/:id/campaigns writes the issue. The 201 body includes id and status. POST /api/newsletters/:id/campaigns/:campaign_id/publish sends it. A sent issue answers 422.
curl -X POST https://pigeonfs.com/api/newsletters/$NEWSLETTER_ID/campaigns \ -H "Authorization: Bearer $PIGEON_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name":"Sunday notes","subject":"What shipped this week","html":"<p>Hello {{name}}</p>"}' curl -X POST https://pigeonfs.com/api/newsletters/$NEWSLETTER_ID/campaigns/$CAMPAIGN_ID/publish \ -H "Authorization: Bearer $PIGEON_API_KEY"