API > Lists > Create List

POST https://emailoctopus.com/api/1.2/lists

Create a new list.

Parameters
api_key (string) Your API key.
name (string) The name of the new list.
200 (Success) Returns

Details of the new list:

id (string) The identifier of the list.
name (string) The name of the list.
created_at (string) When the list was created, in ISO 8601 format.
Non-200 (Error) Returns

Details of the error:

code (string) The error code.
message (string) A description of the error.
Method-specific Error Codes
None.
API-wide Error Codes
INVALID_PARAMETERS Parameters are missing or invalid.
API_KEY_INVALID Your API key is invalid.
UNAUTHORISED You're not authorised to perform that action.
NOT_FOUND The requested endpoint does not exist.
UNKNOWN An unknown error has occurred.
Example Request
                        
                            {
                                "api_key": "00000000-0000-0000-0000-000000000000",
                                "name": "Foo"
                            }
                        
                    
Example Response
                        
                            {
                                "id": "00000000-0000-0000-0000-000000000000",
                                "name": "Foo",
                                "created_at": "2017-11-21T00:00:00+00:00"
                            }