> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Manage saved contact views in your Allo CRM

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 |

```json theme={null}
{
  "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 the `key` of a custom field from [List custom fields](https://help.withallo.com/en/v2/api-reference/crm/list-attributes.md).
* `operator`: one of `IS`, `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 returns `INVALID_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 as `created_at`. Otherwise the request returns `INVALID_FILTER_VALUE`. Ignored for `EMPTY` and `NOT_EMPTY`.

> [!NOTE]
>
> View filters use explicit `{ field, operator, value }` conditions, unlike the named `filters` object of [Search people](https://help.withallo.com/en/v2/api-reference/crm/search-people.md). This is intentional: it lets a view created in the app come back through the API exactly as it was saved, and a view created with the API open in the app unchanged.

## 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](https://help.withallo.com/en/v2/api-reference/crm/list-attributes.md). 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`.

## Endpoints

> **[List views](https://help.withallo.com/en/v2/api-reference/crm/list-views.md)**
>
> List the views you can see

> **[Get view](https://help.withallo.com/en/v2/api-reference/crm/get-view.md)**
>
> Get one view

> **[Create view](https://help.withallo.com/en/v2/api-reference/crm/create-view.md)**
>
> Create a view

> **[Update view](https://help.withallo.com/en/v2/api-reference/crm/update-view.md)**
>
> Edit a view

> **[Delete view](https://help.withallo.com/en/v2/api-reference/crm/delete-view.md)**
>
> Delete a view


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.