Newsletter
A Newsletter is a list of Contacts who subscribed to a Startup’s issues by email, with the Offer that gates its paid issues.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
name | string | required | What subscribers see it called. |
from | Mailbox | required | The broadcast Mailbox each issue sends from. |
topic | string | The topic a Contact subscribes to, recorded with their Consent. | |
subscribers | integer | Contacts subscribed now, counted from their Consent. | |
offer | Offer | The Offer whose Subscription unlocks paid issues and the archive. |
Object
{
"$id": "https: //api.sb/ leaseline.app/ newsletters/ newsletter_FLjN3aQujc",
"$type": "Newsletter",
"name": "Leaseline notes",
"from": "mailbox_93HvOnR17L",
"topic": "product-updates",
"subscribers": 1,
"offer": "offer_2hzYe1ERo0"
}Relationships
- A Newsletter sends from one Mailbox: every issue sends from one broadcast Mailbox.
sendsFrom, inversenewsletters.
Verbs
createCreates a Newsletter.POST /{namespace}/newslettersgetReturns one Newsletter by id.GET /{namespace}/newsletters/{id}listReturns Newsletters, newest first, one page at a time.GET /{namespace}/newslettersupdateChanges the given properties of a Newsletter.PATCH /{namespace}/newsletters/{id}deleteDeletes a Newsletter: a soft delete that keeps its history, undone by `Thing.restore`.DELETE /{namespace}/newsletters/{id}importImport adds subscribers from a CSV File, keeping each one’s consent basis and the date they subscribed.POST /{namespace}/newsletters/{newsletter}/importsendSend emails one issue, a piece of Content, to every subscribed Contact, and a paid issue only to those whose Offer covers it.POST /{namespace}/newsletters/{newsletter}/send
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Newsletter.create | Yes | Yes | Yes | No |
Newsletter.get | Yes | Yes | Yes | Yes |
Newsletter.list | Yes | Yes | Yes | Yes |
Newsletter.update | Yes | Yes | Yes | No |
Newsletter.delete | Yes | Yes | Yes | No |
Newsletter.import | Yes | Yes | Yes | No |
Newsletter.send | Yes | No | No | No |
Call it
In code: API · SDK · CLI · MCP.
Send the latest newsletter with content.Works with
| With | Links |
|---|---|
| Roles | Marketing Lead |
| Systems | Email list |
| Guides | Start a newsletter |
Example
Leaseline’s Newsletter on lease law sends from its broadcast Mailbox to 900 subscribers. The monthly issue goes to all of them; the weekly issue goes only to subscribers whose Subscription to the $8 Offer covers it.