Minimal webhooks

Minimal webhooks send lightweight payloads that include only essential data.

How minimal webhooks work

All minimal webhooks are sent as JSON payloads with the following headers:

Header	Value
`X-Signable-Webhook`	Unix timestamp
`Content-Type`	`application/json`

Event payloads

All payloads include these base fields:

action – the event type
action_date – the event timestamp in ISO 8601 format
company_id - the unique identifier for the Signable account

In addition to event-specific fields listed below.

Contact Created

Event type: add-contact

{
    "action": "add-contact",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "contact_id": "17224073" 
}

Field	Type	Description
`contact_id`	string	The unique ID of the contact

Template Created

Event type: add-template

{
    "action": "add-template",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "template_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309"
}

Field	Type	Description
`template_fingerprint`	string	The unique ID of the template

User Created

Event type: add-user

{
    "action": "add-user",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "user_id": "836499"
}

Field	Type	Description
`user_id`	string	The unique ID of the user

Email Bounced

Event type: bounced-envelope

{
    "action": "bounced-envelope",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309",
    "envelope_title": "Tenancy 88 Smith Street",
    "envelope_bounce_email": "abby@singable.co.uk",
    "envelope_bounce_reason": "unable to get mx info: failed to get IPs from PTR record: lookup <nil>: unrecognized address",
    "envelope_bounce_url": "https://app.signable.co.uk/envelope/bounce/584ea8b41b0d4c17a96b967433b211e6/584ea8b41b0d4c17a96b967433b211e6"
}

Field	Type	Description
`envelope_fingerprint`	string/null	The unique fingerprint of the related envelope
`envelope_title`	string/null	The title of the related envelope
`envelope_bounce_email`	string	The email address that bounced
`envelope_bounce_reason`	string	The reason the email failed to deliver
`envelope_bounce_url`	string	URL with further bounce information

Envelope Cancelled

Event type: cancelled-envelope

{
    "action": "cancelled-envelope",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309"
}

Field	Type	Description
`envelope_fingerprint`	string	The unique ID of the envelope

Envelope Expired

Event type: expired-envelope

{
    "action": "expired-envelope",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309"
}

Field	Type	Description
`envelope_fingerprint`	string	The unique ID of the envelope

Envelope Opened

Event type: opened-envelope

{
    "action": "opened-envelope",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309",
    "party_id": "20576938",
    "contact_id": "17224073",
    "user_id": "836499"
}

Field	Type	Description
`envelope_fingerprint`	string	The unique ID of the envelope
`party_id`	string	The ID of the party who opened the envelope
`contact_id`	string	The unique ID of the associated contact
`user_id`	string	The unique ID of the envelope owner

Envelope Rejected

Event type: rejected-envelope

{
    "action": "rejected-envelope",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309",
    "party_id": "20576938",
    "contact_id": "17224073",
    "user_id": "836499"
}

Field	Type	Description
`envelope_fingerprint`	string	The unique ID of the envelope
`party_id`	string	The ID of the party who rejected the envelope
`contact_id`	string	The unique ID of the associated contact
`user_id`	string	The unique ID of the envelope owner

Envelope Sent

Event type: send-envelope

{
    "action": "send-envelope",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309",
    "party_id": "20576938",
    "contact_id": "17224073",
    "user_id": "836499"
}

Field	Type	Description
`envelope_fingerprint`	string	The unique ID of the envelope
`party_id`	string	The ID of the party the envelope was sent to
`contact_id`	string	The unique ID of the associated contact
`user_id`	string	The ID of the envelope owner

Envelope Process Failed

Event type: send-envelope-failed

{
    "action": "send-envelope-failed",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309"
}

Field	Type	Description
`envelope_fingerprint`	string	The unique ID of the envelope

Envelope Signed

Event type: signed-envelope

{
    "action": "signed-envelope",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309",
    "party_id": "20576938",
    "contact_id": "17224073",
    "user_id": "836499"
}

Field	Type	Description
`envelope_fingerprint`	string	The unique ID of the envelope
`party_id`	string	The ID of the party who signed
`contact_id`	string	The unique ID of the associated contact
`user_id`	string	The unique ID of the envelope owner

Envelope Complete

Event type: signed-envelope-complete

{
    "action": "signed-envelope-complete",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309"
}

Field	Type	Description
`envelope_fingerprint`	string	The unique ID of the envelope

Event type: signed-envelope-widget

{
    "action": "signed-envelope-widget",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309",
    "party_id": "20576938",
    "contact_id": "17224073",
    "user_id": "836499"
}

Field	Type	Description
`envelope_fingerprint`	string	The unique ID of the envelope
`party_id`	string	The ID of the verified party
`contact_id`	string	The unique ID of the associated contact
`user_id`	string	The unique ID of the envelope owner

Event type: verify-envelope-widget

{
    "action": "verify-envelope-widget",
    "action_date": "2026-03-18T12:00:00+00:00",
    "company_id": "196735",
    "envelope_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309",
    "party_id": "20576938",
    "contact_id": "17224073",
    "user_id": "836499"
}

Field	Type	Description
`envelope_fingerprint`	string	The unique ID of the envelope
`party_id`	string	The ID of the party to be verified
`contact_id`	string	The unique ID of the associated contact
`user_id`	string	The unique ID of the envelope owner

⬅️ Back to Webhook improvements

Minimal webhooks

How minimal webhooks work

Event payloads

Contact Created

Template Created

User Created

Email Bounced

Envelope Cancelled

Envelope Expired

Envelope Opened

Envelope Rejected

Envelope Sent

Envelope Process Failed

Envelope Signed

Envelope Complete

Widget Signer Verified

Envelope Widget Verify

Was this helpful?

Minimal webhooks

How minimal webhooks work

Event payloads

Contact Created

Template Created

User Created

Email Bounced

Envelope Cancelled

Envelope Expired

Envelope Opened

Envelope Rejected

Envelope Sent

Envelope Process Failed

Envelope Signed

Envelope Complete

Widget Signer Verified

Envelope Widget Verify

Related documentation

Was this helpful?