# Contact: Manage Many Contacts

Manage multiple contacts by adding, removing or unsubscribing them from multiple contact lists. Separate actions are set for each list and implemented for all contacts listed.

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.

Endpoint: POST /v3/REST/contact/managemanycontacts
Version: 1.0.0
Security: basicAuth

## Request fields (application/json):

  - `Contacts` (array, required)
    A JSON array, containing information about the contacts. Each contact is represented by its Email, Name, optional campaign 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.

  - `ContactsLists` (array)
    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.JobID` (integer)
    Unique numeric Job ID returned after a POST /contact/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