Skip to main content
DELETE
/
contact-lists
/
{contactListId}
curl --request DELETE \
  --url https://api.autosend.com/v1/contact-lists/60d5ec49f1b2c72d9c8b4567 \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "message": "Contact list deleted successfully",
  "data": {
    "id": "60d5ec49f1b2c72d9c8b4567",
    "name": "Newsletter Subscribers",
    "description": "Weekly newsletter subscribers",
    "type": "list",
    "filterCriteria": null,
    "contactCount": 150,
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-20T14:45:00.000Z",
    "parentId": null
  }
}

curl --request DELETE \
  --url https://api.autosend.com/v1/contact-lists/60d5ec49f1b2c72d9c8b4567 \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "message": "Contact list deleted successfully",
  "data": {
    "id": "60d5ec49f1b2c72d9c8b4567",
    "name": "Newsletter Subscribers",
    "description": "Weekly newsletter subscribers",
    "type": "list",
    "filterCriteria": null,
    "contactCount": 150,
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-20T14:45:00.000Z",
    "parentId": null
  }
}

​
Authorizations

​
Authorizations
string | header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Path Parameters

​
contactListId
string
required
The unique identifier of the contact list to delete.Example: "60d5ec49f1b2c72d9c8b4567"
You cannot delete a contact list that is currently used in active workflows. Remove the list from all workflows before deleting.

​
Response

Contact list deleted successfully
​
success
boolean
Indicates if the request was successfulExample: true
​
message
string
Confirmation messageExample: "Contact list deleted successfully"
​
data
object
The deleted contact list object

​
Error Responses

​
400 - Contact list in use
object
Returned when the contact list is used in active workflow automations.
{
  "success": false,
  "error": {
    "message": "Cannot delete contact list as it is used in active resources.",
    "code": "CANNOT_DELETE_CONTACT_LIST_IN_USE",
    "status": 400
  }
}
​
404 - Contact list not found
object
Returned when no contact list with the given ID exists on the project.
{
  "success": false,
  "error": {
    "message": "Contact list not found",
    "code": "CONTACT_LIST_NOT_FOUND",
    "status": 404
  }
}