> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/face-collections/create-collection.md).

# Criar coleção

Serviço que cria uma coleção facial na qual registrar rostos.

### Endpoint

```
POST /biometric/face/collections
```

### Cabeçalhos

| Nome              | Tipo   | Obrigatório | Descrição                                                                                                                   |
| ----------------- | ------ | ----------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Authorization** | string | **Sim**     | Token de consumer no formato `Bearer <token>`. Ver [Autenticação](/docs.facephi-pt-br/api-rest/midapi-v2/autenticacion.md). |
| **consumer-id**   | string | **Sim**     | Identificador do consumer.                                                                                                  |

### Corpo da solicitação

**Content-Type:** `application/json`

#### Parâmetros

| Parâmetro      | Tipo   | Obrigatório | Descrição                              |
| -------------- | ------ | ----------- | -------------------------------------- |
| `collectionId` | string | **Sim**     | Identificador da coleção a ser criada. |

#### Exemplo de solicitação

```json
{
  "collectionId": "clientes-web"
}
```

### Respostas

#### `200` Sucesso

#### Parâmetros de resposta

| Parâmetro       | Tipo   | Descrição                                                   |
| --------------- | ------ | ----------------------------------------------------------- |
| `consumerId`    | string | Identificador do consumer que realizou a chamada.           |
| `transactionId` | string | Identificador da transação.                                 |
| `timestamp`     | string | Carimbo de data e hora da resposta no formato **ISO 8601**. |
| `message`       | string | Campo descritivo do resultado da execução do serviço.       |
| `collectionId`  | string | Identificador da coleção criada.                            |

#### Outras respostas

| Código | Descrição                                                               |
| ------ | ----------------------------------------------------------------------- |
| `401`  | Token ausente, inválido ou expirado.                                    |
| `403`  | O consumer não está provisionado com o serviço `FACE_COLLECTION_ADMIN`. |

O corpo de uma resposta de erro tem o formato descrito em [MIDAPI v2](/docs.facephi-pt-br/api-rest/midapi-v2.md#respuestas-de-error).