API > Lists > Create Contact Of A List

POST https://emailoctopus.com/api/1.5/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.
fields (object, optional) An object containing key/value pairs of field values, using the field's tag as the key.
status (string, optional) The initial status of the contact (SUBSCRIBED, UNSUBSCRIBED or PENDING).
If omitted, will default to PENDING for lists with double opt-in enabled, or SUBSCRIBED for lists without.
200 (Success) Returns

Details of the new contact:

id (string) The identifier of the contact.
email_address (string) The email address of the contact.
fields (object) An object containing key/value pairs of field values, using the field's tag as the key.
status (string) The status of the contact (SUBSCRIBED, UNSUBSCRIBED or PENDING).
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",
    
    "fields": {
        "FirstName": "Joe",
        "LastName": "Bloggs"
    },
    "status": "SUBSCRIBED"
}

                        
                    
Example Response
                        
                                {
    "id": "00000000-0000-0000-0000-000000000000",
    
    "email_address": "john.doe@example.com",
    
    "fields": {
        "FirstName": "John",
        "LastName": "Doe"
    },
    "status": "SUBSCRIBED",
    "created_at": "2018-12-11T00:00:00+00:00"
}