listmonk website screenshot

listmonk

listmonk is a free and open-source, self-hosted newsletter and mailing-list manager built in Go with a Vue front end. Every feature in the admin UI is backed by a documented REST API on the self-hosted instance (Basic auth with an API user and token) covering subscribers, lists, campaigns, templates, media, CSV import, transactional messages, and bounces. There is no hosted SaaS - users run their own instance.

listmonk publishes 8 APIs on the APIs.io network, including Bounces API, Campaigns API, Import API, and 5 more. Tagged areas include Email, Newsletter, Mailing List, Open Source, and Self-Hosted.

listmonk’s developer surface includes authentication, documentation, and 8 more developer resources.

33.4/100 thin ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
AccessFreemiumSelf serve⚡ Free to try
8 APIs
EmailNewsletterMailing ListOpen SourceSelf-Hosted

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 33.4/100 · thin
Contract Quality 12.4 / 25
Developer Ergonomics 3.9 / 20
Commercial Clarity 5.8 / 20
Operational Transparency 4.8 / 13
Governance 0.0 / 12
Discoverability 6.5 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/listmonk: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 8

Individual APIs this provider publishes, each with its own machine-readable definition.

listmonk Bounces API

The Bounces API from listmonk — 2 operation(s) for bounces.

listmonk Campaigns API

The Campaigns API from listmonk — 8 operation(s) for campaigns.

listmonk Import API

The Import API from listmonk — 2 operation(s) for import.

listmonk Lists API

The Lists API from listmonk — 3 operation(s) for lists.

listmonk Media API

The Media API from listmonk — 2 operation(s) for media.

listmonk Subscribers API

The Subscribers API from listmonk — 10 operation(s) for subscribers.

listmonk Templates API

The Templates API from listmonk — 5 operation(s) for templates.

listmonk Transactional API

The Transactional API from listmonk — 1 operation(s) for transactional.

Scroll for all 8

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

listmonk API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Listmonk Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Listmonk Authentication

apiKey/http · 2 schemes

SECURITY

Listmonk Domain Security

TLSv1.3

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Listmonk Agentic Access

53 operations · 34 acting · 1 human-in-the-loop

53 operations · 34 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: listmonk
url: https://raw.githubusercontent.com/api-evangelist/listmonk/refs/heads/main/apis.yml
name: listmonk
kind: company
description: listmonk is a free and open-source, self-hosted newsletter and mailing-list manager built in Go with a Vue front
  end. Every feature in the admin UI is backed by a documented REST API on the self-hosted instance (Basic auth with an API
  user and token) covering subscribers, lists, campaigns, templates, media, CSV import, transactional messages, and bounces.
  There is no hosted SaaS - users run their own instance.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/listmonk.png
tags:
- Email
- Newsletter
- Mailing List
- Open Source
- Self-Hosted
created: '2026-06-25'
modified: '2026-06-25'
specificationVersion: '0.19'
apis:
- aid: listmonk:listmonk-bounces-api
  name: listmonk Bounces API
  description: The Bounces API from listmonk — 2 operation(s) for bounces.
  humanURL: https://listmonk.app/docs/apis/subscribers/
  baseURL: http://localhost:9000/api
  tags:
  - Bounces
  properties:
  - type: OpenAPI
    url: openapi/listmonk-bounces-api-openapi.yml
  - type: Documentation
    url: https://listmonk.app/docs/apis/subscribers/
  - type: APIReference
    url: https://listmonk.app/docs/apis/apis/
  - type: Documentation
    url: https://listmonk.app/docs/apis/lists/
  - type: Documentation
    url: https://listmonk.app/docs/apis/campaigns/
  - type: Documentation
    url: https://listmonk.app/docs/apis/templates/
  - type: Documentation
    url: https://listmonk.app/docs/apis/media/
  - type: Documentation
    url: https://listmonk.app/docs/apis/transactional/
  - type: Documentation
    url: https://listmonk.app/docs/apis/import/
  - type: Documentation
    url: https://listmonk.app/docs/apis/bounces/
- aid: listmonk:listmonk-campaigns-api
  name: listmonk Campaigns API
  description: The Campaigns API from listmonk — 8 operation(s) for campaigns.
  humanURL: https://listmonk.app/docs/apis/subscribers/
  baseURL: http://localhost:9000/api
  tags:
  - Campaigns
  properties:
  - type: OpenAPI
    url: openapi/listmonk-campaigns-api-openapi.yml
  - type: Documentation
    url: https://listmonk.app/docs/apis/subscribers/
  - type: APIReference
    url: https://listmonk.app/docs/apis/apis/
  - type: Documentation
    url: https://listmonk.app/docs/apis/lists/
  - type: Documentation
    url: https://listmonk.app/docs/apis/campaigns/
  - type: Documentation
    url: https://listmonk.app/docs/apis/templates/
  - type: Documentation
    url: https://listmonk.app/docs/apis/media/
  - type: Documentation
    url: https://listmonk.app/docs/apis/transactional/
  - type: Documentation
    url: https://listmonk.app/docs/apis/import/
  - type: Documentation
    url: https://listmonk.app/docs/apis/bounces/
- aid: listmonk:listmonk-import-api
  name: listmonk Import API
  description: The Import API from listmonk — 2 operation(s) for import.
  humanURL: https://listmonk.app/docs/apis/subscribers/
  baseURL: http://localhost:9000/api
  tags:
  - Import
  properties:
  - type: OpenAPI
    url: openapi/listmonk-import-api-openapi.yml
  - type: Documentation
    url: https://listmonk.app/docs/apis/subscribers/
  - type: APIReference
    url: https://listmonk.app/docs/apis/apis/
  - type: Documentation
    url: https://listmonk.app/docs/apis/lists/
  - type: Documentation
    url: https://listmonk.app/docs/apis/campaigns/
  - type: Documentation
    url: https://listmonk.app/docs/apis/templates/
  - type: Documentation
    url: https://listmonk.app/docs/apis/media/
  - type: Documentation
    url: https://listmonk.app/docs/apis/transactional/
  - type: Documentation
    url: https://listmonk.app/docs/apis/import/
  - type: Documentation
    url: https://listmonk.app/docs/apis/bounces/
- aid: listmonk:listmonk-lists-api
  name: listmonk Lists API
  description: The Lists API from listmonk — 3 operation(s) for lists.
  humanURL: https://listmonk.app/docs/apis/subscribers/
  baseURL: http://localhost:9000/api
  tags:
  - Lists
  properties:
  - type: OpenAPI
    url: openapi/listmonk-lists-api-openapi.yml
  - type: Documentation
    url: https://listmonk.app/docs/apis/subscribers/
  - type: APIReference
    url: https://listmonk.app/docs/apis/apis/
  - type: Documentation
    url: https://listmonk.app/docs/apis/lists/
  - type: Documentation
    url: https://listmonk.app/docs/apis/campaigns/
  - type: Documentation
    url: https://listmonk.app/docs/apis/templates/
  - type: Documentation
    url: https://listmonk.app/docs/apis/media/
  - type: Documentation
    url: https://listmonk.app/docs/apis/transactional/
  - type: Documentation
    url: https://listmonk.app/docs/apis/import/
  - type: Documentation
    url: https://listmonk.app/docs/apis/bounces/
- aid: listmonk:listmonk-media-api
  name: listmonk Media API
  description: The Media API from listmonk — 2 operation(s) for media.
  humanURL: https://listmonk.app/docs/apis/subscribers/
  baseURL: http://localhost:9000/api
  tags:
  - Media
  properties:
  - type: OpenAPI
    url: openapi/listmonk-media-api-openapi.yml
  - type: Documentation
    url: https://listmonk.app/docs/apis/subscribers/
  - type: APIReference
    url: https://listmonk.app/docs/apis/apis/
  - type: Documentation
    url: https://listmonk.app/docs/apis/lists/
  - type: Documentation
    url: https://listmonk.app/docs/apis/campaigns/
  - type: Documentation
    url: https://listmonk.app/docs/apis/templates/
  - type: Documentation
    url: https://listmonk.app/docs/apis/media/
  - type: Documentation
    url: https://listmonk.app/docs/apis/transactional/
  - type: Documentation
    url: https://listmonk.app/docs/apis/import/
  - type: Documentation
    url: https://listmonk.app/docs/apis/bounces/
- aid: listmonk:listmonk-subscribers-api
  name: listmonk Subscribers API
  description: The Subscribers API from listmonk — 10 operation(s) for subscribers.
  humanURL: https://listmonk.app/docs/apis/subscribers/
  baseURL: http://localhost:9000/api
  tags:
  - Subscribers
  properties:
  - type: OpenAPI
    url: openapi/listmonk-subscribers-api-openapi.yml
  - type: Documentation
    url: https://listmonk.app/docs/apis/subscribers/
  - type: APIReference
    url: https://listmonk.app/docs/apis/apis/
  - type: Documentation
    url: https://listmonk.app/docs/apis/lists/
  - type: Documentation
    url: https://listmonk.app/docs/apis/campaigns/
  - type: Documentation
    url: https://listmonk.app/docs/apis/templates/
  - type: Documentation
    url: https://listmonk.app/docs/apis/media/
  - type: Documentation
    url: https://listmonk.app/docs/apis/transactional/
  - type: Documentation
    url: https://listmonk.app/docs/apis/import/
  - type: Documentation
    url: https://listmonk.app/docs/apis/bounces/
- aid: listmonk:listmonk-templates-api
  name: listmonk Templates API
  description: The Templates API from listmonk — 5 operation(s) for templates.
  humanURL: https://listmonk.app/docs/apis/subscribers/
  baseURL: http://localhost:9000/api
  tags:
  - Templates
  properties:
  - type: OpenAPI
    url: openapi/listmonk-templates-api-openapi.yml
  - type: Documentation
    url: https://listmonk.app/docs/apis/subscribers/
  - type: APIReference
    url: https://listmonk.app/docs/apis/apis/
  - type: Documentation
    url: https://listmonk.app/docs/apis/lists/
  - type: Documentation
    url: https://listmonk.app/docs/apis/campaigns/
  - type: Documentation
    url: https://listmonk.app/docs/apis/templates/
  - type: Documentation
    url: https://listmonk.app/docs/apis/media/
  - type: Documentation
    url: https://listmonk.app/docs/apis/transactional/
  - type: Documentation
    url: https://listmonk.app/docs/apis/import/
  - type: Documentation
    url: https://listmonk.app/docs/apis/bounces/
- aid: listmonk:listmonk-transactional-api
  name: listmonk Transactional API
  description: The Transactional API from listmonk — 1 operation(s) for transactional.
  humanURL: https://listmonk.app/docs/apis/subscribers/
  baseURL: http://localhost:9000/api
  tags:
  - Transactional
  properties:
  - type: OpenAPI
    url: openapi/listmonk-transactional-api-openapi.yml
  - type: Documentation
    url: https://listmonk.app/docs/apis/subscribers/
  - type: APIReference
    url: https://listmonk.app/docs/apis/apis/
  - type: Documentation
    url: https://listmonk.app/docs/apis/lists/
  - type: Documentation
    url: https://listmonk.app/docs/apis/campaigns/
  - type: Documentation
    url: https://listmonk.app/docs/apis/templates/
  - type: Documentation
    url: https://listmonk.app/docs/apis/media/
  - type: Documentation
    url: https://listmonk.app/docs/apis/transactional/
  - type: Documentation
    url: https://listmonk.app/docs/apis/import/
  - type: Documentation
    url: https://listmonk.app/docs/apis/bounces/
common:
- type: AgenticAccess
  url: agentic-access/listmonk-agentic-access.yml
- type: DomainSecurity
  url: security/listmonk-domain-security.yml
- type: Authentication
  url: authentication/listmonk-authentication.yml
- type: GitHubOrganization
  url: https://github.com/knadh/listmonk
- type: LinkedIn
  url: https://www.linkedin.com/in/knadh
- type: Website
  url: https://listmonk.app
- type: Documentation
  url: https://listmonk.app/docs/apis/apis/
- type: Plans
  url: plans/listmonk-plans-pricing.yml
- type: RateLimits
  url: rate-limits/listmonk-rate-limits.yml
- type: FinOps
  url: finops/listmonk-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com