> ## 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 rascunho de assinatura incremental

> Primeiro passo da assinatura incremental em etapas: cria o rascunho só com as configurações.

Cria a assinatura incremental em rascunho, no estado "Enviar arquivos", sem documento nem signatário. Ninguém é avisado até o [`send`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-send). Cada passo seguinte fica gravado no rascunho, então quem monta o pedido numa tela pode recarregar a página sem perder nada.

Para criar e enviar em uma única chamada, use [`POST /signer/v1/incremental-signatures`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-signature). As regras do modo incremental estão em [Assinatura incremental](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/assinatura-incremental.md).

## Parâmetros

**title** `string` *required*

Título, ex.: `"CCB 2026-0001"`. Máximo 255 caracteres.

**dueDate** `string` *required*

Vencimento (ISO 8601). Precisa estar no futuro.

**reminderEveryHours** `integer`

Frequência dos lembretes, em horas. Padrão: 24.

**signingMode** `enum`

`sequential` (na ordem da lista) ou `parallel` (todos ao mesmo tempo). Padrão: `parallel`. Não muda depois de criado o rascunho.

**notificationChannel** `enum`

`EMAIL`, `SMS` ou `NONE`. Com `NONE` ninguém é avisado e `urlNotification` passa a ser obrigatória.

**urlNotification** `string`

URL HTTPS que recebe os eventos (`SENT`, `SIGNED`, `REFUSED`, `FINISHED`, `CANCELLED` e `EXPIRED`). Obrigatória com `notificationChannel=NONE`.

## Respostas

**envelopeUuid** `string`

Identificador do rascunho. Use-o nas chamadas seguintes.

**stateId** `integer`

Estado do rascunho: 1 Enviar arquivos, 3 Inserir signatários, 4 Posicionar assinatura, 5 Conferência, 6 Aguardando assinatura.

**state** `string`

Nome do estado.

**title** `string`

Título.

**dueDate** `string`

Vencimento (ISO 8601).

**reminderEveryHours** `integer`

Frequência dos lembretes, em horas.

**signingMode** `string`

`sequential` ou `parallel`.

**notificationChannel** `string`

`EMAIL`, `SMS` ou `NONE`.

**urlNotification** `string`

Webhook, ou `null`.

**createdAt** `string`

Criação (ISO 8601).

## Erros

Veja [Autenticação e erros](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/erros-e-autenticacao.md).

* **400**: Título vazio, vencimento no passado ou canal inválido.

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

{
  "envelopeUuid": "550e8400-e29b-41d4-a716-446655440000",
  "title": "CCB 2026-0001",
  "stateId": 1,
  "state": "Enviar arquivos",
  "dueDate": "2026-12-31T23:59:59.000Z",
  "reminderEveryHours": 24,
  "signingMode": "parallel",
  "notificationChannel": "EMAIL",
  "urlNotification": null,
  "createdAt": "2026-11-13T10:30:00.000Z"
}
```

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X POST "https://api.valid.com/signer/v1/incremental-signatures/drafts" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "CCB 2026-0001", "dueDate": "2026-12-31T23:59:59.000Z", "notificationChannel": "EMAIL"}'
```

## Os passos

1. **Enviar arquivos**: [`POST .../:uuid/documents`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-document), um por chamada. Depois, [`advance`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-advance).
2. **Inserir signatários**: [`PUT .../:uuid/signers`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/put-incremental-signers). Depois, `advance`.
3. **Posicionar assinatura**: [`placement-mode`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/put-incremental-signer-placement-mode) e [`position`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/put-incremental-signer-position) de cada signatário. Depois, `advance`.
4. **Conferência**: [`send`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-send).

Para corrigir algo antes do envio, use [`PATCH .../:uuid/settings`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/patch-incremental-settings) ou [`POST .../:uuid/back`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-back).


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