Skip to main content
Este endpoint permite reenviar um envelope existente, gerando novos emails de notificação para os destinatários.
cURL
# Reenviar contrato de trabalho após correção de email do funcionário
curl -X POST "https://api.formsign.com.br/api/envelopes/resend" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "envelopeId": "env_contrato_trabalho_2024_045"
  }'

Parâmetros (Body)

envelopeId
string
required
ID do envelope a ser reenviado.

Como Funciona

  1. Validação: Verifica se o envelope existe e pertence ao usuário
  2. Status Check: Confirma se o envelope pode ser reenviado (deve estar com status sent)
  3. Reenvio: Gera novos emails para todos os destinatários pendentes
  4. Log: Registra a ação no histórico do envelope

Quando Usar

  • Destinatário não recebeu o email original
  • Email foi para spam/lixo eletrônico
  • Necessidade de lembrar destinatários pendentes
  • Após alteração de dados de contato

Regras de Negócio

  • Envelope deve ter status sent
  • Envelope não pode estar completed, voided ou expired
  • Apenas destinatários pendentes recebem novo email
  • Destinatários que já assinaram não são notificados novamente

Respostas

{
  "message": "Success",
  "envelopeId": "env_abc123456789"
}

Status Válidos para Reenvio

StatusPode Reenviar?Motivo
sentStatus normal para reenvio
draftEnvelope ainda não foi enviado
completedTodas assinaturas já coletadas
voidedEnvelope foi cancelado
expiredEnvelope expirou

Campos da Response

message
string
Mensagem de confirmação (“Success”).
envelopeId
string
ID do envelope reenviado.
Limite de Reenvios: Não há limite técnico, mas use com moderação para evitar spam. Considere usar lembretes automáticos via advancedOptions.autoReminders.
O reenvio gera novos tokens de acesso, invalidando links anteriores de destinatários pendentes. Destinatários que já assinaram mantêm seus dados.