Skip to main content
Newsletters allow finer control over distribution of site content via email, allowing members to opt-in or opt-out of different categories of content. By default each site has one newsletter.

​
The newsletter object

// GET admin/newsletters/?limit=50
{
    "newsletters": [
        {
            "id": "62750bff2b868a34f814af08",
            "name": "My Ghost site",
            "description": null,
            "slug": "default-newsletter",
            "sender_name": null,
            "sender_email": null,
            "sender_reply_to": "newsletter",
            "status": "active",
            "visibility": "members",
            "subscribe_on_signup": true,
            "sort_order": 0,
            "header_image": null,
            "show_header_icon": true,
            "show_header_title": true,
            "title_font_category": "sans_serif",
            "title_alignment": "center",
            "show_feature_image": true,
            "body_font_category": "sans_serif",
            "footer_content": null,
            "show_badge": true,
            "created_at": "2022-05-06T11:52:31.000Z",
            "updated_at": "2022-05-20T07:43:43.000Z",
            "show_header_name": true,
            "uuid": "59fbce16-c0bf-4583-9bb3-5cd52db43159"
        }
    ],
    "meta": {
        "pagination": {
            "page": 1,
            "limit": 50,
            "pages": 1,
            "total": 1,
            "next": null,
            "prev": null
        }
    }
}
KeyDescription
namePublic name for the newsletter
description(nullable) Public description of the newsletter
statusactive or archived - denotes if the newsletter is active or archived
slugThe reference to this newsletter that can be used in the newsletter option when sending a post via email
sender_name(nullable) The sender name of the emails
sender_email(nullable) The email from which to send emails. Requires validation.
sender_reply_toThe reply-to email address for sent emails. Can be either newsletter (= use sender_email) or support (use support email from Portal settings).
subscribe_on_signuptrue/false. Whether members should automatically subscribe to this newsletter on signup
header_image(nullable) Path to an image to show at the top of emails. Recommended size 1200x600
show_header_icontrue/false. Show the site icon in emails
show_header_titletrue/false. Show the site name in emails
show_header_nametrue/false. Show the newsletter name in emails
title_font_categoryTitle font style. Either serif or sans_serif
show_feature_imagetrue/false. Show the post’s feature image in emails
body_font_categoryBody font style. Either serif or sans_serif
footer_content(nullable) Extra information or legal text to show in the footer of emails. Should contain valid HTML.
show_badgetrue/false. Show you’re a part of the indie publishing movement by adding a small Ghost badge in the footer
⌘I