# Contact List: Manage Contact

Manage the presence and subscription status of a contact to a specific contact list. The API will internally create the new contact if it does not exist, as well as add or update the name and properties. To obtain a valid list_ID, first call GET /v3/REST/contactslist to list your contact lists.

Endpoint: POST /v3/REST/contactslist/{list_ID}/managecontact
Version: 1.0.0
Security: basicAuth

## Path parameters:

  - `list_ID` (integer, required)
    Unique numeric ID assigned to this contact list.
    Example: 2000

## Request fields (application/json):

  - `Action` (string, required)
    Action to be performed on the contact for this list:

- addforce - Add the contact to this list and subscribe all of them. If the contact is already present in the list as unsubscribed, it will be forcibly subscribed once again.
- addnoforce - Add the contact to this list and subscribe them to it. If the contact is already present, it will retain its subscription status, i.e. if a contact is part of the list, but unsubscribed, it will not be forcibly subscribed again.
- remove - Remove the contact from this list
- unsub - Unsubscribe the contact from this list

  - `Email` (string, required)
    The email address of this contact.

  - `Name` (string)
    User-defined name for the contact.

  - `Properties` (object)
    A JSON object containing contact properties and their values. Each property is listed with its name as the parameter name,  and the property value as the parameter value. The properties must have been created beforehand.

## Response 201 fields (application/json):

  - `Count` (integer)
    Indicates the number of objects in the Data array.

  - `Data` (array)
    A JSON array containing a list of objects returned by this endpoint.

  - `Data.Action` (string)
    Action performed on the contact for this list:

- addforce - Add the contact to this list and subscribe all of them. If the contact is already present in the list as unsubscribed, it will be forcibly subscribed once again.
- addnoforce - Add the contact to this list and subscribe them to it. If the contact is already present, it will retain its subscription status, i.e. if a contact is part of the list, but unsubscribed, it will not be forcibly subscribed again.
- remove - Remove the contact from this list
- unsub - Unsubscribe the contact from this list

  - `Data.Email` (string)
    The email address of this contact.

  - `Data.Name` (string)
    User-defined name for the contact.

  - `Data.Properties` (object)
    A JSON object containing contact properties and their values. Each property is listed with its name as the parameter name,  and the property value as the parameter value. The properties must have been created beforehand.

  - `Total` (integer)
    Indicates the number of objects in the Data array.


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields