> ## Documentation Index
> Fetch the complete documentation index at: https://docs.annature.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

# Recipient declined

Triggered when a recipient declines to sign the envelope.

The payload includes an optional `declined_reason` — a free-text message that the recipient may enter when declining. While not mandatory, this message often explains the reason for their decision.

> Declining a document does **not** automatically void the envelope. You may choose to void it, update the recipient’s details, or send them a reminder — depending on your workflow.

If you choose to send the recipient a reminder after they’ve declined, their status will automatically revert to `sent`, allowing them to reopen and complete the envelope.

<ResponseExample>
  ```json theme={null}
  {
    "event": "recipient_declined",
    "recipient_id": "255e591c2c9fe1bc99be1ec03075b402",
    "envelope_id": "7e8f68e4c6df9395cd7ff48d69d7e2c1",
    "declined": "2019-12-17T05:30:00Z",
    "declined_reason": ""
  }
  ```
</ResponseExample>
