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

# Adicionar signatário

> Insere um novo signatário em um processo de assinatura.

## Path Parameters

<ParamField path="signature_process" type="string" required>
  UUID do processo de assinatura. **Exemplo**:
  `e7d4f2aa-34bc-4321-ae11-123456789abc`
</ParamField>

## Body Parameters

<ParamField body="name" type="string" required>
  Nome do signatário. **Exemplo**: `João da Silva`
</ParamField>

<ParamField body="email" type="string" required>
  E-mail do signatário. **Exemplo**: `joao@example.com`
</ParamField>

<ParamField body="code" type="string">
  Código interno do signatário. **Exemplo**: `SIGN001`
</ParamField>

<ParamField body="identifier" type="string">
  CPF do signatário. **Exemplo**: `12345678909`
</ParamField>

<ParamField body="qualification" type="string">
  Qualificação (ex: Cargo). **Exemplo**: `Advogado`
</ParamField>

<ParamField body="signature_process_type_id" type="integer">
  Tipo de assinatura: 1 (Digital), 2 (Eletrônico), 3 (Híbrido). **Exemplo**: `1`
</ParamField>

<ParamField body="phone_country_code" type="string">
  DDI do telefone. **Exemplo**: `55`
</ParamField>

<ParamField body="phone_number" type="string">
  Número do telefone. **Exemplo**: `11999999999`
</ParamField>

<ParamField body="birth_date" type="string">
  Data de nascimento (YYYY-MM-DD). **Exemplo**: `1990-01-01`
</ParamField>

<ParamField body="token_type" type="integer">
  Tipo de token. **Exemplo**: `1`
</ParamField>

<ParamField body="files_uuids" type="array">
  Lista de UUIDs dos arquivos que o signatário deve assinar.
</ParamField>

<ParamField body="options" type="object">
  Opções adicionais.

  <Expandable title="properties">
    <ResponseField name="send_init_emails" type="boolean">
      Enviar e-mails de inicialização. **Exemplo**: `true`
    </ResponseField>
  </Expandable>
</ParamField>

## Response

<ResponseField name="message" type="string">
  Mensagem de sucesso. **Exemplo**: `Signatário inserido com sucesso.`
</ResponseField>

<ResponseField name="code" type="string">
  Código do signatário. **Exemplo**: `SIGN001`
</ResponseField>

<ResponseField name="uuid" type="string">
  UUID do signatário criado. **Exemplo**: `d7d3ac84-1234-4bbb-bbbb-abcdefabcdef`
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={"theme":"catppuccin-latte"}
  {
    "message": "Signatário inserido com sucesso.",
    "code": "SIGN001",
    "uuid": "d7d3ac84-1234-4bbb-bbbb-abcdefabcdef"
  }
  ```

  ```json 400 Requisição inválida theme={"theme":"catppuccin-latte"}
  ```

  ```json 401 Não autenticado theme={"theme":"catppuccin-latte"}
  ```

  ```json 403 Não autorizado theme={"theme":"catppuccin-latte"}
  ```

  ```json 500 Internal Server Error theme={"theme":"catppuccin-latte"}
  ```
</ResponseExample>