# Envelope email bounced

Triggered when an email to a signer fails to deliver.


Endpoint: POST bounced-envelope
Version: 1.0.0
Security: basicAuth

## Request fields (application/x-www-form-urlencoded):

  - `action` (string, required)
    The action taken. Defaults to .
    Example: "bounced-envelope"

  - `action_date` (string, required)
    The UTC timestamp of when the email bounced
    Example: "2025-08-07T11:33:03+00:00"

  - `company_id` (integer, required)
    The ID of the company that owns the envelope
    Example: 64034

  - `envelope_bounce_email` (string, required)
    The email address that bounced
    Example: "abby@singable.co.uk"

  - `envelope_bounce_reason` (string, required)
    The reason the email failed to deliver
    Example: "unable to get mx info: failed to get IPs from PTR record: lookup <nil>: unrecognized address"

  - `envelope_bounce_url` (string, required)
    A link to view the bounce details
    Example: "https://app.signable.co.uk/envelope/bounce/584ea8b41b0d4c17a96b967433b211e6/584ea8b41b0d4c17a96b967433b211e6"

  - `envelope_fingerprint` (string, required)
    A string identifying the bounced envelope
    Example: "584ea8b41b0d4c17a96b967433b211e6"

  - `envelope_meta` (string)
    A JSON string of any meta information added to the envelope
    Example: "{\"envelope_title\":\"Word Doc.docx\"}"

  - `client_ip` (string, required)
    The IP address from which the bounce originated
    Example: "198.51.100.36"