Send Listmonk Campaigns from Paperclip

Paperclip agents can create and schedule Listmonk email campaigns through Postiz. Install the Postiz skill where the agent runs, connect your self-hosted Listmonk instance in Postiz, and the agent can write the email body, set the subject and preview text, pick the subscriber list and template, and schedule the send.

Setup Guide Paperclip

Please make sure there is always a human in the loop.

Last updated: September 2026

Send a Listmonk Campaign in Seconds

Setup, then just ask

# One-time setup
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then just ask Paperclip:
> Send the monthly newsletter to the
  Customers list tomorrow at 9am

Paperclip: Done! Your Listmonk post is scheduled.

Listmonk-Specific Features

📧

Email Campaigns

Create and send email campaigns to your subscriber lists with rich HTML content, subject lines, and preview text.

📋

Mailing Lists

Target specific subscriber lists by ID. Send campaigns to the right audience segment every time.

🎨

Template Support

Use pre-built email templates by specifying a template ID. Maintain consistent branding across all campaigns.

👁

Preview Text

Set preview text that appears in email clients before the recipient opens the message. Boost open rates with compelling previews.

📰

Newsletter Automation

Automate recurring newsletters with scheduled sends. Let AI agents craft and deliver content on a regular cadence.

📅

Scheduled Delivery

Schedule email campaigns for optimal delivery times. Use ISO timestamps to send at exactly the right moment.

How does Paperclip post to Listmonk?

You describe what you want in plain language and Paperclip handles the Postiz calls for you. Here is how a typical conversation goes.

Find Your Listmonk Integration

Ask Paperclip whether your Listmonk account is connected. It also checks which options the platform supports.

Example conversation

> Is my Listmonk account connected to Postiz?

Paperclip: Yes — your Listmonk account is connected
  and ready. Want me to post something?

Compose Your Email

Write your email body in plain text or HTML. Tell Paperclip the subject line and preview text and it sets them.

Example conversation

> Draft a Listmonk post about our new
  feature launch

Paperclip: Here's a draft for Listmonk:
  "We just shipped something big..."
  Want me to add media and schedule it?

Schedule and Send

Schedule your email campaign for a specific time or send immediately. Target a specific list and optionally apply a template for consistent formatting.

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

Paperclip: Done! Scheduled on Listmonk for
  tomorrow at 9:00 AM.

Listmonk Settings Reference

Mention any of these in plain language and Paperclip sets them for you. These are the options every Listmonk campaign can carry.

Field	Type	Required	Description
`__type`	string	Yes	Must be "listmonk" to identify the platform
`subject`	string	Yes	Email subject line (min 1 character)
`preview`	string	Yes	Preview text shown in email clients before opening
`list`	string	Yes	List ID to send the campaign to
`template`	string	No	Template ID to use for the email layout

Common Configurations

Ask Paperclip for any of these common Listmonk campaign scenarios and it applies the matching settings.

Weekly Newsletter

Just ask

> Post it with: Weekly Newsletter

Paperclip: Got it. Applying:
  subject: Weekly Newsletter - March Edition
  preview: This week: new features, tips, and community highlights
  list: list-1
  template: newsletter-tmpl

Product Announcement

Just ask

> Post it with: Product Announcement

Paperclip: Got it. Applying:
  subject: Introducing Our New Feature
  preview: We've been working on something big...
  list: list-2

Promotional Campaign with Template

Just ask

> Post it with: Promotional Campaign with Template

Paperclip: Got it. Applying:
  subject: Flash Sale - 48 Hours Only
  preview: Up to 50% off everything in store
  list: list-3
  template: promo-template

Plain Text Update

Just ask

> Post it with: Plain Text Update

Paperclip: Got it. Applying:
  subject: A quick note from the team
  preview: Important updates about your account
  list: list-1

What is Paperclip?

Paperclip is an open-source orchestration framework for building “zero-human companies” by hiring and managing teams of AI agents. It handles content, social media distribution, marketing, dev, QA, and more from a single dashboard.

👥

Agent Teams

Paperclip manages teams of AI agents that work together. Assign a content agent, a scheduling agent, and a review agent to your social media workflow.

📊

Single Dashboard

Monitor all your AI agents and their social media tasks from one unified dashboard. Track posts, schedules, and performance in real time.

⚙

Orchestration

Schedule recurring tasks with cron jobs. Paperclip can send your Listmonk campaigns on a schedule without you having to ask each time.

How Postiz Works with Paperclip

When you install Postiz Agent globally, Paperclip automatically discovers it by reading the bundled SKILL.md file. This file tells Paperclip what commands are available, what environment variables are needed, and how to compose Listmonk campaigns with the right settings.

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Paperclip discovers Postiz through tool integration
✓Assign Postiz commands to specialized agents in your team
✓Orchestrate multi-step workflows with approval chains
✓Monitor everything from the Paperclip dashboard

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Paperclip discovers Postiz through
# its tool integration system
# and assigns it to agent teams

Listmonk Campaigns with Paperclip

Message Paperclip from any platform — it reads the Postiz skill, discovers your Listmonk integration, and handles the entire email campaign workflow autonomously.

📎

From Any Chat App

Paperclip assigns specialized agents to ...

Assign a task to Paperclip from its dashboard. It runs as a long-lived service on your own infrastructure, so it picks up the task, discovers your Listmonk integration via Postiz, composes the email, and sends the campaign — all while you go about your day.

Paperclip

Content Agent: Drafted a post about
  the feature launch for Listmonk.

Review Agent: Approved with minor
  edits. Ready to publish.

Scheduling Agent: Found Listmonk
  integration via Postiz.
  Scheduled for tomorrow 9:00 AM.

  Post ID: abc-123
  Status: Scheduled

📎

Scheduled & Proactive

Cron jobs for recurring newsletters

Paperclip supports scheduled heartbeats. Set up a recurring job that generates newsletter content and sends it to your Listmonk lists automatically — no manual trigger needed.

paperclip.yaml (pipeline)

pipelines:
  daily_social:
    schedule: "0 9 * * 1-5"
    agents:
      - role: content_creator
        task: "Draft a Listmonk post
          about trending industry topics"
      - role: reviewer
        task: "Review and polish the
          draft for engagement"
      - role: publisher
        task: "Schedule via Postiz
          for today at noon"

Why Paperclip + Postiz for Listmonk

Paperclip makes Postiz a natural fit for your Listmonk workflow. The agent discovers all available commands and autonomously chains them together.

✓Multi-agent teams for quality Listmonk content — draft, review, publish
✓Single dashboard to monitor all social media automation
✓Orchestrated pipelines from content creation to publishing
✓Scheduled pipelines for hands-free daily posting
✓Cross-post to Listmonk + other platforms in a single pipeline
✓Open-source — fully customizable agent workflows

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Listmonk
metadata:
  paperclip:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Listmonk Settings
subject, preview, list, template

Also Works with Claude Code

Postiz works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the Postiz skill so it knows what it can do, then autonomously discovers your Listmonk integration, composes your email campaign with subject, preview text, and list targeting, and sends it on schedule.

Claude Code

> Send a newsletter to list-1 about our
  new feature launch, schedule for Monday

Claude: Done! Scheduled on Listmonk for
  tomorrow at 9:00 AM.

Listmonk + Other Platforms

Send an email campaign and post to social media simultaneously. Each platform gets its own settings.

Example

> Post "Excited to announce our new feature!" to
  Listmonk and LinkedIn tomorrow at 9am, then schedule
  a daily tip on Listmonk every weekday at 10am

Paperclip: Done! Scheduled:
  - Listmonk + LinkedIn: tomorrow 9:00 AM
  - Daily tips on Listmonk: Mon-Fri 10:00 AM

What can you ask Paperclip to do on Listmonk?

You assign a task in plain language and the agent translates it into Postiz calls with the right Listmonk settings. These are prompts people actually give a Paperclip agent for Listmonk.

Weekly newsletter

Ask Paperclip

> Send this week's product update to the
  Customers list on Friday at 10am, subject
  "What shipped this week", use the Newsletter template

Paperclip: subject, preview, list, template set.
  Campaign scheduled for Fri 10:00 AM.

Repurpose a blog post

Ask Paperclip

> Turn blog/launch.md into an email for the
  Trial Users list with a short preview line

Paperclip: Body drafted, preview: 90 characters.
  Ready to schedule.

Coordinated launch

Ask Paperclip

> Send the launch email at 9am and post the same
  news to LinkedIn and X at 9:15

Paperclip: Campaign at 9:00 AM, social posts at 9:15 AM.

What Listmonk rules should the agent follow?

Listmonk rejects posts that break its limits, so the agent needs these constraints up front. Put them in the task or in your Paperclip agent's instructions.

✓subject, preview, and list are required. preview is the inbox preheader text shown next to the subject line.
✓list is the Listmonk list ID. The agent resolves it from the list name through Postiz; sending to the wrong list is the most common mistake, so confirm it.
✓template is optional and takes a Listmonk template ID. Without it, Listmonk uses your default template.
✓The post body becomes the email content. Ask the agent for a plain-text fallback and to test-send to yourself before a large list.

Paperclip and Listmonk: frequently asked questions

Short answers to the questions teams ask before letting a Paperclip agent post to Listmonk through Postiz.

How do I send a Listmonk campaign from Paperclip?

Install the Postiz skill in your agent's environment with npx skills add gitroomhq/postiz-agent, set POSTIZ_API_KEY, and connect your Listmonk instance in Postiz. Then assign a task such as "send the weekly update to the Customers list Friday at 10am" and the agent creates and schedules the campaign.

Why is Listmonk in a social media tool like Postiz?

Because launches rarely stop at social. Postiz treats Listmonk as another channel so a single Paperclip task can send the newsletter and post to LinkedIn, X, and Facebook with matching timing. Listmonk is open source and self-hosted, which fits the Postiz and Paperclip stack.

Which Listmonk fields does a Paperclip agent have to fill?

Three are required: subject, preview (the preheader shown in inboxes), and list (the subscriber list ID). template is optional. The agent drafts the subject and preview from your brief, resolves the list ID from the list name, and schedules the send time through Postiz.

Can I make Paperclip test the email before it sends to everyone?

Yes, by giving it a small internal list first. Ask the agent to send the campaign to your "Team" list, review it in your inbox, then approve a follow-up task that targets the full list. Paperclip's approval workflow is designed for exactly this kind of gate.

Can Paperclip run a recurring newsletter through Listmonk?

Yes. A writer agent compiles the week's updates, a reviewer checks tone and links, and a publisher schedules the campaign through Postiz, all on a Paperclip heartbeat. Because the list and template stay fixed, the recurring task only changes the subject, preview, and body each week.