Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

CRM

getList MembersgetGet List MemberpostQuery List MemberspostAdd to ListdelRemove from ListgetGet Contact Lists

Email Marketing

Knowledge

Support

Projects

List Members

Get Contact Lists

Lists every contact list one contact belongs to: the list-membership view for a contact detail page. The inverse of List Members.

GET
/projects/{projectId}/crm/contacts/{contactDistinctId}/contact-lists

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project that owns the contact.

contactDistinctIdrequiredstring

Distinct ID of the contact whose list memberships to return.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://www.saasco.com/api/v2/projects/string/crm/contacts/string/contact-lists"
{
  "count": 0,
  "data": [
    {
      "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": []
}

Remove from List

Removes a contact from a static list, identified by the contact's distinct ID. The contact itself is not deleted. Returns `null` if they were not in the list. Has no lasting effect on a dynamic list, whose membership comes from its filter.

List Types

Lists the notification types a project has defined: the named categories, such as product updates or billing alerts, that contacts can subscribe to independently. Public and unauthenticated so a preference centre can render the available options before the contact is identified.