Webhooks — Evento ENVELOPE_VOIDED - SuperSign

O envelope foi anulado (cancelado) e não pode mais ser assinado. Visão geral de
todos os eventos em Webhooks.

Quando dispara

Anulação feita por uma pessoa na tela.

Anulação pela API.

Anulação automática pelo sistema — por exemplo, quando o envio falha e o
envelope não pode seguir.

Anulação de um envelope ainda em rascunho: nesse caso chega
ENVELOPE_VOIDED sem nunca ter havido ENVELOPE_SENT.

Quando NÃO dispara

Anular de novo um envelope que já estava anulado normalmente não gera outro
evento. Para deduplicar com segurança, use event + data.envelope.id.

Expiração por prazo não é anulação: gera
ENVELOPE_EXPIRED.

Exemplo de payload

{
  "id": "c1b2a3d4-0000-4000-8000-000000000001",
  "event": "ENVELOPE_VOIDED",
  "createdAt": "2026-09-13T14:00:02.000Z",
  "data": {
    "envelope": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "VOIDED",
      "occurredAt": "2026-09-13T14:00:00.000Z",
      "cancellationReason": "Contrato enviado com valor errado"
    },
    "signatories": [
      {
        "id": "7a9e6679-7425-40de-944b-e07fc1f90ae7",
        "name": "Pessoa Exemplo",
        "email": "pessoa@example.com"
      }
    ]
  }
}

Campos de `data`

Campo	Tipo	Descrição
`envelope.id`	string (UUID)	Id do envelope.
`envelope.status`	string	Status no momento em que a entrega foi montada — normalmente `VOIDED`.
`envelope.occurredAt`	string (ISO 8601, UTC)	Quando a anulação aconteceu; bate com a data de anulação mostrada pelo `GET` do envelope.
`envelope.cancellationReason`	string ou `null`	Motivo informado na anulação; `null` quando não houve motivo. Existe só neste evento.
`signatories`	array	Só os participantes com papel de signatário, na ordem de assinatura do envelope.
`signatories[].id`	string (UUID)	Id do participante no envelope.
`signatories[].name`	string ou `null`	Nome do participante.
`signatories[].email`	string ou `null`	E-mail do participante.

O formato externo (id, event, createdAt, environment) e os cabeçalhos
estão em Webhooks → Payload.

O que fazer com ele

Marcar o processo como cancelado no seu sistema e interromper cobranças,
lembretes ou fluxos que dependiam da assinatura.

Registrar o cancellationReason para quem acompanha o processo.

Se precisar assinar de novo, criar um envelope novo: um envelope anulado não
volta a circular.

Webhooks — Evento ENVELOPE_VOIDED

Quando dispara#

Quando NÃO dispara#

Exemplo de payload#

Campos de data#

O que fazer com ele#

Quando dispara

Quando NÃO dispara

Exemplo de payload

Campos de `data`

O que fazer com ele