You can use pip to install mailman-api and requirements:

$ pip install mailman-api

Distro Packages

We are currently working to provide linux packages (deb and rpm). Stay tunned!

Running the Sevice

To start the service manually just run the mailman-api command.

If you installed mailman-api from a distribution package you should be able to start your service by running service mailman-api start.

Usage: mailman-api [options]


-h, --help

show this help message and exit


Bind address. Default: ''.


IPs to allow incoming requests. By deufalt only allow connections from ''.


Path to mailman libs directory. Default: '/usr/lib/mailman'.

-d, --debug

Print debug information


Requests can be made to any of the URI's below, strictly using the HTTP methods indicated.

The body of all responses contains valid JSON objects. Unless otherwise noted, successful requests get as response a 200 (OK) status code for response, and true in the response body. Failed requests will get responses with some HTTP error code in the 400s, and a string describing the problem in the response body.

Supported methods:


Copyright (C) 2013-2014 Sergio Oliveira Campos

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.


Sergio Oliveira


2014, Sergio Oliveira Campos