Create Newsletter
shipmail_create_newsletterCreate a newsletter draft for a specified audience and sender identity. Provide content via blocks, HTML, or plain text; the draft is rendered to email-safe HTML and text for scheduling.
Instructions
Create a newsletter draft for an audience and sender identity. Prefer blocks for body content; Shipmail renders them to email-safe HTML and text. Provide at least one of blocks, body_html, or body_text. Drafts must pass preflight before scheduling. styled applies Shipmail's email theme. plain sends your HTML without injected styles, width, or centering, so the reader's email client styles it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"audience_id": "<audience_id>",
"sender_identity_id": "<sender_identity_id>",
"name": "<name>",
"subject": "<subject>"
},
"name": "shipmail_create_newsletter"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Internal newsletter draft name. | |
| blocks | No | ||
| subject | Yes | Email subject line. | |
| body_html | No | ||
| body_text | No | ||
| audience_id | Yes | Audience ID. | |
| preview_text | No | ||
| styling_mode | No | styled applies Shipmail's email theme. plain sends your HTML without injected styles, width, or centering, so the reader's email client styles it. | |
| idempotency_key | No | Optional idempotency key. If omitted, the MCP server generates one for POST tools. | |
| send_window_hours | No | ||
| archive_visibility | No | ||
| sender_identity_id | Yes | Newsletter sender identity ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| newsletter | Yes |