Use this endpoint to create asynchronous background jobs that remove contacts from one or more contact lists.
Click a method to view its documentation
Privileges required: contacts:write
This endpoint removes the contacts specified by email address in
import_data from the contact lists defined in the
lists array. You need to construct the JSON request payload that contains the contacts and the contact lists they will be removed from. See the JSON Request example for details on constructing the request.
The size of the JSON request payload must be less than 4 megabytes. Also, the number of contacts that you can remove in a single POST is limited to 20,000. The activity request will fail if the payload is greater than 4 MBs or if it contains more 20,000 email addresses.
To see the status of an activity, make a GET call to the URI returned in the response's location header:
Poll this URI to monitor the activity status until the status is either COMPLETE or ERROR, indicating that the activity has completed processing. The response structure for this GET call is detailed here.
See also: Bulk Activity Summary Reports