Our v3 API is now available! Learn more by visiting the v3 developer portal.

Bulk Activities - Clear Contact List

Use this endpoint to create asynchronous background jobs that clear all contacts from an existing contact list.


Click a method to view its documentation



Privileges required: contacts:write

This endpoint clears (removes) all contacts from the contact list specified by listId in the lists array in the JSON request body. See the example JSON Request below for details on constructing the JSON payload.

Activity Status

To see the status of an activity, make a GET call to the URI returned in the response's location header:

Location: https://api.constantcontact.com/v2/activities/<activity_id>

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: Summary Activity Reports API

POST: https://api.constantcontact.com/v2/activities/clearlists

Example JSON Request BodyTOP

Example ResponseTOP