# Contact List: Import List

Add, unsubscribe or remove the contacts present in a list to / from another list. The list ID specified in the body of the payload is the source, while ID in the path specifies the destination list. To obtain a valid list_ID, first call GET /v3/REST/contactslist to list your contact lists.

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

## Path parameters:

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

## Request fields (application/json):

  - `Action` (string, required)
    Action to be performed on the destination 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.
- unsub - Unsubscribe the contacts from this list
- duplicate-override - Add the contacts and duplicate their subscription status from the source list to the destination list. E.g. if in the source list a contact is unsubscribed and in the destination list the same contact is subscribed, the contact will be marked as unsubscribed in the destination list.
- duplicate-no-override - Add the contacts without duplicating their subscription status. E.g. if in the source list a contact is unsubscribed and in the destination list the same contact is subscribed, the contact will remain subscribed in the destination list.

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

## 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}/importlist 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