Webhooks — Evento ENVELOPE_EXPIRED - SuperSign

O prazo do envelope venceu sem que ele tivesse sido concluído. Visão geral de
todos os eventos em Webhooks.

Quando dispara

Quando o prazo de um envelope em circulação vence e ainda falta alguma
assinatura ou aprovação. A verificação de prazos é periódica, então o evento
pode chegar alguns minutos depois do horário exato do vencimento.

Quando NÃO dispara

Envelope sem prazo definido.

Envelope que foi concluído ou anulado antes do vencimento.

Expirar não é o fim definitivo. Se o prazo de um envelope expirado for
estendido, ele volta a circular e chega um
ENVELOPE_SENT; depois disso ele ainda pode
chegar a ENVELOPE_COMPLETED.

Exemplo de payload

{
  "id": "f0e1d2c3-0000-4000-8000-000000000030",
  "event": "ENVELOPE_EXPIRED",
  "createdAt": "2026-09-30T03:00:05.000Z",
  "data": {
    "envelope": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "EXPIRED",
      "occurredAt": "2026-09-30T03:00:01.000Z"
    },
    "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 `EXPIRED`.
`envelope.occurredAt`	string (ISO 8601, UTC)	Quando a expiração foi registrada.
`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 "prazo vencido" e avisar o responsável.

Para dar mais tempo, estender o prazo do envelope; ele volta a circular e você
recebe ENVELOPE_SENT. Não trate o envelope como encerrado de forma
irreversível.

Para consultar quem ainda não assinou, use GET /v4/api/envelopes/{envelopeId}.

Webhooks — Evento ENVELOPE_EXPIRED

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