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

# Cadastrar contato de signatário

> Adiciona um novo signatário à agenda do projeto.

Cadastra um novo signatário na agenda do seu projeto. Use antes de criar envelopes para reutilizar dados em múltiplos documentos.

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

## Parâmetros

<ParamField body="name" type="string" required>
  Nome completo do signatário.
</ParamField>

<ParamField body="cpf" type="string" required>
  CPF (com ou sem máscara).
</ParamField>

<ParamField body="email" type="string" required>
  E-mail.
</ParamField>

<ParamField body="phoneCountryCode" type="string" optional>
  Código de país (ex.: `55`). Se omitido e houver celular, padrão é `55`.
</ParamField>

<ParamField body="phoneNumber" type="string" optional>
  Número de celular (só dígitos).
</ParamField>

<ParamField body="birthDate" type="string" optional>
  Data de nascimento (AAAA-MM-DD).
</ParamField>

<ParamField body="qualification" type="string" optional>
  Qualificação (ex.: `"Contratante"`, `"Testemunha"`).
</ParamField>

## Respostas

Retorna o objeto de contato criado (201 Created).

## Erros

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

* **400**: Dados inválidos (CPF/e-mail/data inválidos).
* **409**: CPF já cadastrado neste projeto.

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

  {
    "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "name": "João Silva",
    "cpf": "12345678901",
    "cpfFormatted": "123.456.789-01",
    "email": "joao@empresa.com",
    "phoneCountryCode": "55",
    "phoneNumber": "11987654321",
    "birthDate": "1990-05-15",
    "qualification": "Contratante",
    "createdAt": "2025-07-27T10:30:00Z"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X POST "https://api.valid.com/signer/v1/signer-contacts" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "João Silva",
    "cpf": "123.456.789-01",
    "email": "joao@empresa.com",
    "phoneCountryCode": "55",
    "phoneNumber": "11987654321",
    "birthDate": "1990-05-15",
    "qualification": "Contratante"
  }'
```

## Relacionado

* [`GET .../by-cpf/:cpf`](/plataforma/assinatura-digital/api/get-signer-contact-by-cpf) — verificar se já existe
* [`PUT .../signer-contacts/:uuid`](/plataforma/assinatura-digital/api/put-signer-contact) — atualizar contato


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