Draft campaign
campaign_draftCreates a campaign as a DRAFT. Nothing is sent and no quota is used. Before calling: read brand_get for the voice, pick a template from templates_list, and pick the audience from segments_list. You fill the content blocks; Hollerpost renders the email with the brand header, footer and unsubscribe link. Optionally ask one survey question (survey) that readers answer with one click. Returns the id, audience_count and a preview_url to share with the person. Next step: campaign_preview, then campaign_send_test. Retail promo in one call (template promo): {"info_bar": {"text": "Free shipping over $99", "url": "https://shop.example/shipping"}, "image_url": "https://images.hollerpost.com/...", "image_alt": "...", "image_link": "https://shop.example/sale", "heading": "Up to 30% off", "body_md": "...", "cta_text": "Shop the sale", "cta_url": "https://shop.example/sale", "cta_repeat": "bottom", "layout": "grid-2", "sections": [{"heading": "Maple cue", "price": "$129", "image_url": "https://images.hollerpost.com/...", "image_alt": "Maple cue", "cta_text": "Shop now", "cta_url": "https://shop.example/p/1"}], "fine_print": "Ends Sunday. Not valid with other offers.", "theme": {"button_style": "outline", "button_shape": "pill"}}. The footer link buttons, Follow us icons and disclaimer come from the brand (brand_set_footer), not the blocks. Every send also gets a View in browser link, the mailing address and an unsubscribe link automatically. Requires API key scope: draft.
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": {
"name": "<name>",
"template_id": "<template_id>",
"subject": "<subject>",
"blocks": "<blocks>",
"audience": "<audience>"
},
"name": "campaign_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Internal campaign name (recipients do not see it). | |
| blocks | Yes | Content blocks for the template. Check templates_list for the blocks_schema of the template you pick. Never send raw HTML: Hollerpost renders the blocks with the brand header, footer, unsubscribe link and address. The plain template takes no images. | |
| survey | No | Ask one survey question in the email; readers answer with one click. The survey must be open (survey_update with status "open") before the campaign can be test-sent or scheduled. | |
| subject | Yes | Email subject line. | |
| audience | Yes | Who gets it: {"tags": ["vip"]} for tagged contacts, or {"all": true} for every subscribed contact, or {"signup_form_id": "<UUID>"} for a waitlist. | |
| preheader | No | Preview text shown after the subject in most inboxes. | |
| template_id | Yes | Template id from templates_list. |