Send Ghost Newsletters
Send email newsletters through Ghost's built-in newsletter feature via the Admin API
Instructions
Send Ghost Newsletters
Prerequisites
- Ghost instance with newsletter feature enabled
- Subscriber list with segmented members
Steps
-
Configure newsletter settings via API. Use the Ghost Admin API to manage newsletter configuration:
GET /ghost/api/admin/newsletters/ PUT /ghost/api/admin/newsletters/<id>/ { "newsletters": [{ "sender_name": "Your Name", "sender_email": "hello@company.com" }] } -
Create a newsletter post via API. Create a post with email delivery enabled:
POST /ghost/api/admin/posts/ { "posts": [{ "title": "Weekly Update: March 2025", "html": "<p>Newsletter content...</p>", "email_segment": "status:free", "newsletter": { "id": "<newsletter-id>" } }] }Choose recipient segment: all subscribers, free members, paid members, or a specific label.
-
Write for email format. Keep paragraphs short -- email renders differently than web. Ghost posts double as email content, so optimize for both.
-
Send a test email. Use the Ghost Admin API to send a test email before broadcasting to verify formatting, links, and images render correctly.
-
Publish and send. Update the post status to
publishedwithemail_only: trueor both web and email. Schedule for optimal send time (Tuesday-Thursday, 9-11am). -
Monitor analytics via API. Query post analytics:
GET /ghost/api/admin/posts/<id>/Check email open rates, click rates, and unsubscribes. Target: >40% open rate, >5% click rate, <0.5% unsubscribe rate.