# Contact: Manage Contact Lists

Manage the presence and subscription status of a contact for multiple contact lists. Select the contact lists, as well as the desired action to be performed on each one - add, remove or unsub. The contact should already be present in the global contact list. To obtain a valid contact_ID, first call GET /v3/REST/contact to list your contacts.

Endpoint: POST /v3/REST/contact/{contact_ID}/managecontactslists
Version: 1.0.0
Security: basicAuth

## Path parameters:

  - `contact_ID` (integer, required)
    Unique numeric ID of the contact you want to manage the subscription status of.
    Example: 1000

## Request fields (application/json):

  - `ContactsLists` (array, required)
    A JSON array, containing information about the contact lists and the actions performed for each list.

  - `ContactsLists.ListID` (integer, required)
    Unique numeric ID of the contact list.

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

 * addforce - Add the contacts to this list and subscribe all of them. Any contacts already present in the list and unsubscribed from it will be forcibly subscribed once again.

 * addnoforce - Add the contacts to this list and subscribe them to it. Any contacts already present will retain their subscription status, i.e. if a contact is part of the list, but unsubscribed, it will not be forcibly subscribed again.

 * remove - Remove the contacts from this list.

 * unsub - Unsubscribe the contacts from this list.
    Enum: "addforce", "addnoforce", "remove", "unsub"

## 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.ContactsLists` (array)
    A JSON array, containing information about the contact lists and the actions performed for each list.

  - `Data.ContactsLists.ListID` (integer)
    Unique numeric ID of the contact list.

  - `Data.ContactsLists.Action` (string)
    Action to be performed on the contacts for this list:

 * addforce - Add the contacts to this list and subscribe all of them. Any contacts already present in the list and unsubscribed from it will be forcibly subscribed once again.

 * addnoforce - Add the contacts to this list and subscribe them to it. Any contacts already present will retain their subscription status, i.e. if a contact is part of the list, but unsubscribed, it will not be forcibly subscribed again.

 * remove - Remove the contacts from this list.

 * unsub - Unsubscribe the contacts from this list.
    Enum: same as `ContactsLists.Action` (4 values)

  - `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