# Contact List: Manage Many Contacts

Manage multiple contacts by adding, removing or unsubscribing them from a specific contact list. Once you submit the POST request, it will return a JobID, which you can use to verify the success of the POST request, as well as see what kind of errors came up. To obtain a valid list_ID, first call GET /v3/REST/contactslist to list your contact lists.

Endpoint: POST /v3/REST/contactslist/{list_ID}/managemanycontacts
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 contacts for this list:

- addforce - Add the contacts 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 contacts 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 contacts from this list
- unsub - Unsubscribe the contacts from this list

  - `Contacts` (array, required)
    A JSON array, containing information about the contacts. Each contact is represented by its Email, Name, exclusion state and Properties.

  - `Contacts.Email` (string, required)
    The email address for the contact.

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

  - `Contacts.IsExcludedFromCampaigns` (boolean)
    When true, the contact will be added to the exclusion list and will not be receiving any marketing emails.

Default value: false

  - `Contacts.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 property objects must have been created beforehand via the /contactmetadata resource.

## 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.JobID` (integer)
    Job ID assigned to a POST /contactslist/{list_id}/managemanycontacts request. Use it to monitor the progress and success of the request.

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