> ## 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.

# Vue d'ensemble

> Gérez les vues de contacts enregistrées dans votre CRM Allo

Une vue est un filtre et un tri nommés sur vos personnes, les mêmes vues que vous créez sur la page Contacts de l'app Allo. Les vues créées dans l'app et via l'API sont les mêmes objets. L'API Vues permet de les lister, les créer, les modifier et les supprimer.

## Scopes

| Scope | Accès |
| - | - |
| `CRM_READ` | Lister et lire les vues |
| `CRM_WRITE` | Créer et modifier des vues |
| `CRM_DELETE` | Supprimer des vues |

## L'objet vue

| Champ | Type | Description |
| - | - | - |
| `id` | string | ID public de la vue, préfixé `cvw_` |
| `name` | string | Nom affiché, 255 caractères maximum |
| `filters` | array | Conditions `{ field, operator, value }`, combinées avec ET |
| `sort` | array | 2 entrées `{ field, order }` maximum. `order` vaut `asc` ou `desc` |
| `owner_type` | string | `USER` ou `TEAM` |
| `user_id` | string | ID de l'utilisateur propriétaire de la vue |
| `team_id` | string ou null | ID de l'équipe, pour une vue `TEAM` |
| `created_at` | string | Date de création |
| `updated_at` | string | Date de dernière modification |

```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"
}
```

## Filtres

Chaque filtre est une condition `{ field, operator, value }`, et toutes les conditions d'une vue sont combinées avec ET, 50 maximum par vue. `value` est toujours une chaîne.

* `field` : un champ natif d'une personne (`name`, `company`, `job_title`, `emails`, `phone_numbers`, `website`, `addresses`, `created_at`, `updated_at`, `last_activity`, `activity_history`, `sms_content` (uniquement si l'équipe a des SMS)) ou la `key` d'un champ personnalisé de [Lister les champs personnalisés](https://help.withallo.com/fr/v2/api-reference/crm/list-attributes.md).
* `operator` : l'un de `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`. L'opérateur doit correspondre au type du champ, sinon la requête renvoie `INVALID_FILTER_OPERATOR`.
* `value` : doit être lisible pour le type du champ : numérique pour un champ nombre, une date ISO 8601 (`2026-01-31`) ou date-heure (`2026-01-31T00:00:00Z`) pour un champ date comme `created_at`. Sinon la requête renvoie `INVALID_FILTER_VALUE`. Ignorée pour `EMPTY` et `NOT_EMPTY`.

> [!NOTE]
>
> Les filtres d'une vue utilisent des conditions explicites `{ field, operator, value }`, contrairement à l'objet `filters` nommé de [Rechercher des personnes](https://help.withallo.com/fr/v2/api-reference/crm/search-people.md). C'est voulu : une vue créée dans l'app ressort de l'API exactement comme elle a été enregistrée, et une vue créée via l'API s'ouvre dans l'app sans changement.

## Tri

`sort` accepte 2 entrées maximum, chacune avec un `field` et un `order` (`asc` ou `desc`). Les champs natifs triables sont `name`, `company`, `job_title`, `website`, `created_at`, `updated_at`, `last_activity`. Vous pouvez aussi trier sur la `key` d'un champ personnalisé triable de [Lister les champs personnalisés](https://help.withallo.com/fr/v2/api-reference/crm/list-attributes.md). Un `field` inconnu renvoie `INVALID_SORT_FIELD`, et un champ qui ne peut pas être trié renvoie `FIELD_NOT_SORTABLE`.

## Vues privées et vues d'équipe

`owner_type` vaut `USER` par défaut : la vue est privée pour l'utilisateur de la clé API. Passez-le à `TEAM` pour partager la vue avec l'équipe de cet utilisateur ; si l'utilisateur n'a pas d'équipe, la requête renvoie `400 USER_HAS_NO_TEAM`. Modifier ou supprimer une vue d'équipe exige d'en être le propriétaire ou ADMIN ou MANAGER de l'équipe, sinon la requête renvoie `403 VIEW_PERMISSION_DENIED`. La vue privée d'un autre utilisateur ne vous est pas visible et renvoie `404 VIEW_NOT_FOUND`.

## Endpoints

> **[Lister les vues](https://help.withallo.com/fr/v2/api-reference/crm/list-views.md)**
>
> Lister les vues que vous pouvez voir

> **[Obtenir une vue](https://help.withallo.com/fr/v2/api-reference/crm/get-view.md)**
>
> Obtenir une vue

> **[Créer une vue](https://help.withallo.com/fr/v2/api-reference/crm/create-view.md)**
>
> Créer une vue

> **[Modifier une vue](https://help.withallo.com/fr/v2/api-reference/crm/update-view.md)**
>
> Modifier une vue

> **[Supprimer une vue](https://help.withallo.com/fr/v2/api-reference/crm/delete-view.md)**
>
> Supprimer une vue


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