Skip to main content
POST
Creates a list on one type of record. A static list holds the records someone adds. A dynamic list shows the records a query matches and needs cql. Adding entries, columns and shares is done in the app.
Scope crm:write. The token owner needs the right to create lists and to read the type.

Request body

string
required
Up to 120 characters.
string
required
The type of the records, such as company.
string
required
STATIC or DYNAMIC.
string
The query of a dynamic list; not allowed for a static one.
string
default:"PRIVATE"
PRIVATE or SHARED.
string | null
The group of lists it sits in.

Response

The created list, with status 201.
Last modified on November 13, 2026