Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

CRM

getList AllgetGet ListpostCreate ListputUpdate ListdelDelete List

Email Marketing

Knowledge

Support

Projects

Lists

Delete List

Deletes a contact list. The contacts themselves are untouched. Only the list and its membership records go. Any campaign still targeting this list loses its audience. Cannot be undone.

DELETE
/projects/{projectId}/crm/contact-lists/{contactListId}

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project that owns the list.

contactListIdrequiredstring

ID of the contact list to delete.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://www.saasco.com/api/v2/projects/string/crm/contact-lists/string"
{
  "id": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "name": "string",
  "description": "string",
  "type": "static",
  "contactsFilterGroups": [
    {
      "filters": [
        {
          "attributeDistinctId": "string",
          "attributeType": "string",
          "operator": "equals",
          "value": "string"
        }
      ],
      "oneDayEventFilters": [
        {
          "eventName": "string",
          "operator": "performed"
        }
      ],
      "groupType": "AND",
      "requireSubscribed": true
    }
  ],
  "projectId": "string"
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Update List

Updates a contact list's name, description, type, or filter. Only the fields present in `changes` are written. Editing the filter on a dynamic list changes who is in it immediately, since membership is evaluated on read.

List Members

Lists the contacts in a list, with a total `count`. Works for both list kinds. A dynamic list's membership is computed from its filter at read time. Use Query List Members instead when you need extra filtering or to choose which properties come back.