mothermachine

Browse / Content publishing

Mautic

Self-hosted marketing automation: contacts, segments, campaigns, and email, with an official REST API.

AdaptableOperable Business appWeb app Deterministic PHPJavaScript API License: GPL-3.0

Mautic is the largest open-source marketing automation platform: contact database, segments, drip campaigns, email builder, forms, landing pages, and reports, all self-hosted on PHP and MySQL. Configuration lives in config/local.php written by the installer. The Builder documents a REST API at devdocs.mautic.org that an agent uses to manage contacts, segments, emails, and campaigns.

Use it when
  • I want HubSpot-style drips and segments on my own server, with contacts I own
  • I need my agent to add leads, tag them into segments, and trigger campaigns over an API
Gotchas
  • GPL-3.0 (GitHub shows NOASSERTION; composer.json says GPL-3.0)
  • The REST API is disabled by default and must be switched on in Configuration > API Settings
  • Segments, campaigns, and email sends depend on cron jobs; without them nothing moves
  • README warns against running from the GitHub source in production; use the mautic.org package or Composer
  • Requires PHP and MySQL versions matching the release's supported versions page

Last activity Sep 3, 2026. Fit: adaptable 2, operable 3.

Editions

Self-hosted · Free open source

  • Clonegit clone https://github.com/mautic/mautic
  • DownloadDownload
  • Installcomposer create-project mautic/recommended-project

Hosted trial and partners · Free closed source

For agents: JSON · Markdown

Adaptable: what is yours to change

Make it yours

Config only6 things to edit

The installer writes config/local.php with database, mailer, site URL, and API settings; .env only carries APP_ENV and APP_DEBUG. Enable the API under Settings > Configuration > API Settings before an agent can log in. Themes for emails and pages live in themes/ and plugins in plugins/; no code edits are needed to run it as your own automation stack.

Env vars
APP_ENV APP_DEBUG
Config files
config/local.php .env themes/ plugins/
Prompt files
none
Accounts you need
email delivery provider (SMTP, Amazon SES, Sendgrid, Mailgun, or similar)

Source

Operable: what an agent can drive

Interface

OfficialAPIpublished by the builderlocal

How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.

Docs
devdocs.mautic.org/

Reach

Partial coverage. 9 of 10 jobs reachable through the stated interface.

JobThrough the interfaceEvidence
Manage contacts and companiesReachableREST API contacts and companies endpoints (devdocs.mautic.org; triage-confirmed)
Build segmentsReachableREST API segments endpoint with add/remove contact
Create and send emailsReachableREST API emails endpoint with send-to-contact and send-to-segment
Run drip campaignsReachableREST API campaigns endpoint; campaign events are also creatable, with a steeper payload
Collect leads with formsReachableREST API forms endpoint and submissions
Publish landing pagesReachableREST API pages endpoint
Host tracked assetsReachableREST API assets endpoint
Score with points and stagesReachableREST API points, point triggers, and stages endpoints
Pull reportsReachableREST API reports endpoint
Design email and page themesUndeterminedthemes are zip uploads; API theme endpoint existence not verified during analysis

Code stack

Languages
PHPJavaScript
Frameworks
SymfonyDoctrine
Package manager
composer
Database
MySQLMariaDB
Hosting target
LAMP hostDocker (mautic/docker-mautic)DDEV (dev)
Built
Human-written (recorded, never ranked)

Evidence and confidence

FieldWhere it was seenConfidence
formFactorREADME: PHP web application installed with Composer or zip with a web installer95%
executionModelno model at runtime95%
operabilitydevdocs.mautic.org (Builder domain) documents the REST API; endpoint page URL returned 404 during analysis so resource list is from triage plus prior knowledge85%
effortrepo has config/ (installer target for local.php), .env with APP_ENV and APP_DEBUG, themes/ and plugins/80%
editionsREADME: self-host completely free; trials through the mautic.org form80%
activepushedAt 2026-09-03; 179 open issues–
provenanceproject since 2014 with foundation governance; no vibe-coded claim90%
reach65%

Open questions

  • Find the current REST API reference URL under devdocs.mautic.org and verify the endpoint list; the guessed rest_api path 404'd
  • Does the API expose theme upload?
  • Who offers paid hosted Mautic and at what price (Acquia or partners)?

Sources