Guia de criação: O passo a passo padrão

Para colocar um envelope "em progresso", você passará por 5 etapas obrigatórias e uma etapa final de ativação.

💡 O fluxo lógico:

Criar o Envelope (A pasta)
Adicionar documentos (Os arquivos dentro da pasta)
Adicionar signatários (As pessoas que assinarão)
Criar requisitos (A regra: "Quem assina qual documento")
Ativar (O gatilho de envio)

1️⃣ Criando o Envelope

O primeiro passo é gerar o "envelope". Aqui você define o nome do projeto e configurações básicas.

Destaque: Guardar o id retornado; você precisará dele em todos os próximos passos.

Página de referência: Clique aqui.

# Exemplo de criação de rascunho
{
  "data": {
    "type": "envelopes",
    "attributes": {
      "name": "Contrato de Prestação de Serviços - Março 2026"
    }
  }
}

2️⃣ Adicionando documentos

Com o envelope criado, agora você faz o upload do arquivo PDF (em Base64) ou utiliza um modelo (Template) já existente na sua conta.

Endpoint: POST /api/v3/envelopes/:envelope_id/documents

Vínculo: Você deve enviar o envelope_id no corpo da requisição.

Página de referência: Clique aqui.

3️⃣ Cadastrando signatários

Agora, informe quem são as pessoas envolvidas. Você pode identificar o signatário por E-mail ou WhatsApp.

Endpoint: POST /api/v3/envelopes/:envelope_id/signers

Vínculo: Você deve enviar o envelope_id no corpo da requisição.

Página de referência: Clique aqui.

4️⃣ Criando requisitos

Este é o passo mais importante. O signatário só conseguirá assinar se houver um requisito vinculado a ele e ao documento.

É aqui que você define:

Qual documento a pessoa assina.
Qual o papel dela (Assinante, Testemunha, Interveniente).
Qual o método de autenticação (Token, Pix, Biometria, etc).

Endpoint: POST /api/v3/envelopes/:envelope_id/requirements

Página de referência: Clique aqui.

5️⃣ Ativação

Seu envelope está montado, mas ainda está em modo Rascunho (Draft). Para que as notificações sejam enviadas aos signatários, você precisa ativá-lo.

Qual método escolher? Para este guia padrão, utilizaremos o método de atualização direta:

Endpoint: PATCH /api/v3/envelopes/{id}

Ação: Alterar o atributo status para active.

Página de referência: Clique aqui.

{
  "data": {
    "id": "ID_DO_ENVELOPE",
    "type": "envelopes",
    "attributes": {
      "status": "running"
    }
  }
}

✅ Check-list de sucesso

Recebi o status 200 OK na ativação?
Verifiquei se todos os documentos possuem pelo menos dois requisitos?

Próximo passo ➡️

Sua operação cresceu e você precisa de escala? O método PATCH acima vai sofrer lentidão.

Aprenda como escalar sua operação com a Ativação Assíncrona (202 Accepted):

Ativação em Larga Escala.