API > Lists > Create Contact Of A List

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

Create a contact of a list.

Parameters
api_key (string) Your API key.
email_address (string) The email address of the contact.
first_name (string, optional) The first name of the contact.
last_name (string, optional) The last name of the contact.
subscribed (boolean, optional, default true) The initial subscribed status of the contact (true/false).
200 (Success) Returns

Details of the new contact:

id (string) The identifier of the contact.
email_address (string) The email address of the contact.
first_name (string) The first name of the contact.
last_name (string) The last name of the contact.
subscribed (boolean) The subscribed status of the contact.
created_at (string) When the contact 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
MEMBER_EXISTS_WITH_EMAIL_ADDRESS A contact already exists with the supplied email address.
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",
                                
                                "email_address": "joe@bloggs.com",
                                
                                "first_name": "Joe",
                                "last_name": "Bloggs",
                                "subscribed": true
                            }
                        
                    
Example Response
                        
                            {
                                "id": "00000000-0000-0000-0000-000000000000",
                                
                                "email_address": "joe@bloggs.com",
                                
                                "first_name": "Joe",
                                "last_name": "Bloggs",
                                "subscribed": true,
                                "created_at": "2017-11-21T00:00:00+00:00"
                            }