Skip to content

Start building

Integration · Email

AI agents for listmonk

Run a self-hosted listmonk newsletter server: find, add and update subscribers and their list memberships, list mailing lists and campaigns, create campaign drafts and start, pause or schedule them.

Actions
10
Read
4
Write
6

Actions

What your agents can do in listmonk

Run a self-hosted listmonk newsletter server: find, add and update subscribers and their list memberships, list mailing lists and campaigns, create campaign drafts and start, pause or schedule them, and send transactional emails from listmonk templates.

Read 4

Look things up. Nothing changes.

  • Search subscribers

    Lists subscribers at data.results[], newest first: each with id, email, name, status (enabled, disabled, blocklisted), attribs (custom attributes) and lists.

  • Get a subscriber

    Reads one subscriber by ID, at data: email, name, status, attribs and lists with each subscription's status.

  • List mailing lists

    Lists the mailing lists at data.results[]: each with id, name, type (public, private, temporary), optin (single or double), status, tags and subscriber_count.

  • List campaigns

    Lists campaigns, newest first, at data.results[]: each with id, name, subject, status.

Write 6

Create, change or send.

  • Add a subscriber

    Adds a subscriber with an email, a name, custom attributes (usable in templates) and the lists to subscribe them to.

  • Update a subscriber

    Changes a subscriber's email, name, status (enabled, disabled, blocklisted) or attributes (merged with the ones it has).

  • Add to, remove from or unsubscribe from lists

    Adds subscribers to lists (as confirmed, unconfirmed or unsubscribed), removes them from lists, or marks them unsubscribed on lists, for up to 1,000 subscriber IDs at once.

  • Create a campaign draft

    Creates a campaign as a draft: a name, a subject, the list IDs to send to and a body in Markdown, HTML, rich text or plain text, with an optional from address, tags and send time.

  • Start, schedule, pause or cancel a campaign

    Changes a campaign's status: running starts sending now (from draft or paused), scheduled sends at its send time (from draft), paused and cancelled stop a running one.

  • Send a transactional email

    Sends a transactional email using a listmonk transactional template to a subscriber, by email or ID; data fills the template's Tx.Data fields.

A person can approve first

Any write action can be set to wait for a person's approval before it runs, so an agent asks before it changes anything.

Connection

How it connects

Connect it once in the console, then give it to the agents and workflows that need it.

Username and key

Enter the API credentials from your listmonk account.

What you enter

  • API user
  • Token

Settings

  • listmonk address

Kept safe

  • Credentials are stored encrypted with your organization's own keys.
  • They are opened only by the process that makes the call, at the moment it runs, and never go into a prompt or the browser.
  • Calls go only to the tool's own servers.

How we protect your data

Ideas

Ideas to start with

Starting points made only from the actions above. Mix them with any other tool your agents can use.

  • 01

    Ask about your listmonk data

    Ask a question in plain words. The agent can search subscribers, get a subscriber or list mailing lists in listmonk, then answers with what it found.

  • 02

    Let an agent update listmonk

    Have the agent add a subscriber or update a subscriber in listmonk as part of a larger task. Turn on approval and a person signs off on each change first.

  • 03

    Work from your CRM

    Give one agent HubSpot and listmonk: it can search contacts in HubSpot and add a subscriber in listmonk in the same run.

FAQ

listmonk and MyDeepAgents

Can MyDeepAgents connect to listmonk?

Yes. The listmonk connector has 10 actions: 4 read and 6 make changes. Your agents can call them as tools, and your workflows can run them as steps.

How do I connect listmonk?

Enter the API credentials from your listmonk account. You'll need: API user and Token. The connection also asks for: listmonk address. Credentials are stored encrypted with your organization's own keys and are opened only at the moment of a call.

Can an agent change data in listmonk without asking?

Only if you let it. Each of the 6 actions that change data can be set to wait for a person's approval before it runs.

Can I use listmonk in workflows as well as agents?

Yes. Every listmonk action also works as a step in a workflow, and the same connection serves your agents and your workflows.

Early access

Put listmonk to work

Connect it in a few minutes, give an agent the actions it needs, and decide which changes wait for a person.