Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

CRM

getList AttributesdelDelete AttributepostDelete Attributes

Email Marketing

Knowledge

Support

Projects

Attributes

List Attributes

Lists the contact attributes defined in this project: the property names available to filter and segment on, with their inferred types. Custom attributes appear once a contact has been written with that property; set includeSystemAttributes to also get Saasco's built-in $-prefixed ones.

GET
/projects/{projectId}/crm/attributes

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project to list attributes from.

Query Parameters

includeSystemAttributesboolean

Also return Saasco's built-in $-prefixed attributes (geo, device, subscription state) alongside your own custom ones.

skipnumber

Number of attributes to skip before collecting results.

Default: 0
takenumber

Maximum number of attributes to return.

Default: 24

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/attributes"
[
  {
    "id": "string",
    "projectId": "string",
    "totalCount": 0,
    "type": "string",
    "uniqueCount": 0
  }
]
{
  "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": []
}

Migrate Distinct Id

Re-keys a contact from one distinct ID to another, carrying their properties and history across. The usual case is promoting a soft identity to a real one: someone first seen by email gets a `soft_`-prefixed ID, and when they later sign in you migrate that to your own user ID so the two do not persist as separate contacts. Rewriting the analytics history is expensive, so this is not a bulk operation.

Delete Attribute

Removes an attribute from every contact in the project, deleting that property's stored values. Runs as a background job. The response contains job handles rather than a finished result, so the attribute keeps appearing in queries until the job completes. Anything filtering on it, such as a dynamic list, will stop matching. Cannot be undone.