Email list hosting service & mailing list manager

API Specification

These pages detail the raw Simplelists API protocol. This is for programmers only! If available, it is recommended that you use a pre-written module for your particular application. Please follow a link below for more information.

Version 1 API

Our current production API is version 1. This is currently frozen (except for bug fixes) whilst we develop version 2.


Authenticating with the API is performed using OAuth2. Visit the Authentication documentation for full details.


Once authenticated, read about the API protocol for details of how to use API calls to read and write data.


Look at the examples to see example PHP code of authenticating and making API calls.

Version 2 API

We are currently developing version 2 of our API, which will be a complete rewrite of the interface. Please continue to check back for more information.