# 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`


```json
{
    "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`


```json
{
    "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`


```json
{
    "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`


```json
{
    "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`


```json
{
    "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`


```json
{
    "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`


```json
{
    "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`


```json
{
    "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`


```json
{
    "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`


```json
{
    "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`


```json
{
    "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`


```json
{
    "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 |


## Widget Signer Verified

**Event type:** `signed-envelope-widget`


```json
{
    "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 |


## Envelope Widget Verify

**Event type:** `verify-envelope-widget`


```json
{
    "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 |


## Related documentation

- [Create a webhook](/openapi/webhooks/createwebhook)
- [Webhook events](/openapi/webhook-events)


⬅️ Back to [Webhook improvements](/early-access/ea-webook-improvements)