> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar grupo de signatários

> Cria um novo grupo com uma lista de contatos da agenda.

Cria um novo grupo de signatários contendo uma lista ordenada de contatos. Use para agrupar signatários frequentes (ex.: "Diretoria", "Testemunhas") e adicioná-los em massa aos envelopes.

**Autenticação**: `x-api-key` no header. Também aceita `Authorization: Bearer`.

## Parâmetros

<ParamField body="name" type="string" required>
  Nome do grupo (ex.: `"Diretoria"`). Deve ser único no projeto.
</ParamField>

<ParamField body="contactUuids" type="array" required>
  Array de UUIDs de contatos (mínimo 1). Ordem é preservada.
</ParamField>

## Respostas

Retorna o objeto do grupo criado (201 Created).

## Erros

Veja [Autenticação e erros](/plataforma/assinatura-digital/api/erros-e-autenticacao).

* **400**: Lista vazia, ou um dos contatos não pertence à agenda do projeto.
* **409**: Grupo com este nome já existe no projeto.

<ResponseExample>
  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 201 Created
  Content-Type: application/json

  {
    "uuid": "6ba7b820-9dad-11d1-80b4-00c04fd430c9",
    "name": "Diretoria",
    "members": [
      {
        "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "name": "João Silva",
        "cpf": "12345678901",
        "email": "joao@empresa.com"
      },
      {
        "uuid": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
        "name": "Maria Santos",
        "cpf": "98765432109",
        "email": "maria@empresa.com"
      }
    ],
    "createdAt": "2025-07-27T10:30:00Z"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X POST "https://api.valid.com/signer/v1/signer-contact-groups" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Diretoria",
    "contactUuids": [
      "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
    ]
  }'
```

## Importante

* **Ordem importa**: os contatos são adicionados na ordem fornecida.
* **Contatos devem existir**: todos os UUIDs devem estar na agenda do projeto.
* **Nome único**: nomes são únicos por projeto (case-insensitive).

## Relacionado

* [`GET .../signer-contact-groups`](/plataforma/assinatura-digital/api/get-signer-contact-groups) — listar grupos
* [`PUT .../signer-contact-groups/:uuid`](/plataforma/assinatura-digital/api/put-signer-contact-group) — editar grupo


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