A view is a named filter and sort over your people, the same views you create on the Contacts page of the Allo app. Views created in the app and with the API are the same objects. The Views API lets you list, create, edit and delete them.
Scopes
| Scope | Access |
|---|---|
CRM_READ | List and read views |
CRM_WRITE | Create and edit views |
CRM_DELETE | Delete views |
The view object
| Field | Type | Description |
|---|---|---|
id | string | Public ID of the view, prefixed cvw_ |
name | string | Display name, up to 255 characters |
filters | array | { field, operator, value } conditions, combined with AND |
sort | array | Up to 2 { field, order } entries. order is asc or desc |
owner_type | string | USER or TEAM |
user_id | string | ID of the user who owns the view |
team_id | string or null | ID of the team, for a TEAM view |
created_at | string | Creation date |
updated_at | string | Last update date |
{
"id": "cvw_2abc",
"name": "Hot leads",
"filters": [
{
"field": "company",
"operator": "CONTAINS",
"value": "Acme"
}
],
"sort": [
{
"field": "created_at",
"order": "desc"
}
],
"owner_type": "USER",
"user_id": "usr_2abc",
"team_id": null,
"created_at": "2026-10-23T10:00:00",
"updated_at": "2026-10-23T10:00:00"
}
Filters
Each filter is a { field, operator, value } condition, and all the conditions of a view are combined with AND, up to 50 per view. value is always a string.
field: a built-in person field (name,company,job_title,emails,phone_numbers,website,addresses,created_at,updated_at,last_activity,activity_history,sms_content(only when the team has SMS)) or thekeyof a custom field from List custom fields.operator: one ofIS,IS_NOT,CONTAINS,NOT_CONTAINS,EMPTY,NOT_EMPTY,STARTS_WITH,ENDS_WITH,BEFORE,AFTER,DATE_EQUALS,GREATER_THAN,GREATER_THAN_OR_EQUAL,LESS_THAN,LESS_THAN_OR_EQUAL,HAS. The operator must match the type of the field, otherwise the request returnsINVALID_FILTER_OPERATOR.value: must be readable for the type of the field: numeric for a number field, an ISO 8601 date (2026-01-31) or date-time (2026-01-31T00:00:00Z) for a date field such ascreated_at. Otherwise the request returnsINVALID_FILTER_VALUE. Ignored forEMPTYandNOT_EMPTY.
Sort
sort accepts up to 2 entries, each with a field and an order (asc or desc). Sortable built-in fields are name, company, job_title, website, created_at, updated_at, last_activity. You can also sort on the key of a sortable custom field from List custom fields. An unknown field returns INVALID_SORT_FIELD, and a field that cannot be sorted on returns FIELD_NOT_SORTABLE.
Private and team views
owner_type is USER by default: the view is private to the user of the API key. Set it to TEAM to share the view with that user's team; if the user has no team, the request returns 400 USER_HAS_NO_TEAM. Updating or deleting a team view requires being its owner or a team ADMIN or MANAGER, otherwise the request returns 403 VIEW_PERMISSION_DENIED. Another user's private view is not visible to you and returns 404 VIEW_NOT_FOUND.