# Créer une vue

> Champ Type Requis Description ------- ------ -------- ------------- name string oui Nom affiché, 255 caractères maximum filters array non Conditions …

`POST /v2/api/crm/views`

<Note>
**Scope requis :** `CRM_WRITE`
</Note>

## Champs du corps

| Champ | Type | Requis | Description |
|-------|------|--------|-------------|
| `name` | string | oui | Nom affiché, 255 caractères maximum |
| `filters` | array | non | Conditions `{ field, operator, value }`, combinées avec ET. 50 maximum |
| `sort` | array | non | 2 entrées `{ field, order }` maximum. `order` vaut `asc` ou `desc`. `field` est un champ natif triable (`name`, `company`, `job_title`, `website`, `created_at`, `updated_at`, `last_activity`) ou la `key` d'un champ personnalisé triable issue de [Lister les champs personnalisés](/fr/docs/crm/list-attributes) |
| `owner_type` | string | non | `USER` (défaut, privée) ou `TEAM` (partagée avec votre équipe) |

```json
{
  "name": "Hot leads",
  "filters": [
    {
      "field": "company",
      "operator": "CONTAINS",
      "value": "Acme"
    }
  ],
  "sort": [
    {
      "field": "created_at",
      "order": "desc"
    }
  ],
  "owner_type": "USER"
}
```

Voir [Filtres](/fr/docs/crm/views-overview#filtres) pour les champs et opérateurs utilisables.

## Réponse

Renvoie `201` avec la vue.

```json
{
  "data": {
    "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"
  }
}
```

## Erreurs

| Statut | Code | Quand |
|--------|------|-------|
| `400` | `INVALID_REQUEST_BODY` | `name` est absent, vide ou dépasse 255 caractères, `filters` compte plus de 50 entrées, ou `owner_type` n'est ni `USER` ni `TEAM`. Les erreurs par champ sont listées dans `errors[]` avec le `field` (`name` ou `filters`) |
| `400` | `INVALID_FILTER_FIELD` | Le `field` d'un filtre n'est ni un champ natif d'une personne ni la `key` d'un champ personnalisé issue de `GET /v2/api/crm/attributes`. `param` vaut `filters` |
| `400` | `INVALID_FILTER_OPERATOR` | L'`operator` d'un filtre ne correspond pas au type de son champ. Le message nomme le champ. `param` vaut `filters` |
| `400` | `INVALID_FILTER_VALUE` | La `value` d'un filtre n'est pas lisible pour le type de son champ : un champ nombre attend une valeur numérique, un champ date attend une date ISO 8601 comme `2026-01-31` ou `2026-01-31T00:00:00Z`. Le message nomme la valeur et le champ. `param` vaut `filters` |
| `400` | `INVALID_SORT_FIELD` | Le `field` d'un tri n'est ni un champ natif ni la `key` d'un champ personnalisé issue de `GET /v2/api/crm/attributes`. `param` vaut `sort` |
| `400` | `FIELD_NOT_SORTABLE` | Le `field` d'un tri existe mais ne peut pas être trié. Utilisez un champ natif triable ou un champ personnalisé triable. `param` vaut `sort` |
| `400` | `USER_HAS_NO_TEAM` | `owner_type` vaut `TEAM` mais vous n'appartenez à aucune équipe. Utilisez `USER`. `param` vaut `owner_type` |
| `403` | `API_KEY_INSUFFICIENT_SCOPE` | La clé n'a pas le scope `CRM_WRITE` |
