---
title: "Deliverable events"
description: "Receive notifications when signed documents are generated and ready for download."
canonical: "https://signatureapi.com/docs/api/resources/events/deliverable-events"
source: "https://signatureapi.com/docs/api/resources/events/deliverable-events.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T12:10:02Z"
---

# Deliverable events

Receive notifications when signed documents are generated and ready for download.

_Last verified against API version 1.18.0._

Deliverable events notify you when SignatureAPI generates the final signed document (the deliverable), or when generation fails. This page explains each event type, when it fires, and the additional data included in the payload.

> **Tip:** In test mode, send an example event to your webhook handler with the CLI: `npx signatureapi trigger deliverable.generated`. See [CLI webhooks](https://signatureapi.com/docs/cli/webhooks).

## deliverable.generated

Fires when a deliverable is successfully generated and ready for download.

Power Automate trigger: [When a deliverable is generated](https://signatureapi.com/docs/integrations/power-automate/triggers/deliverable-generated).

The `data.url` property contains a pre-signed download link. This URL expires after 1 hour. If it has expired, call the [Retrieve Deliverable](https://signatureapi.com/docs/api/resources/deliverables/get) endpoint to get a fresh link.

#### Example payload

```json JSON
{
    "id": "evt_1a2b3c4d5e6f7g8h9i0j",
    "type": "deliverable.generated",
    "timestamp": "2025-12-31T23:59:59.999Z",
    "data": {
        "object_id": "del_00ZeZjRaXCgT30n1eBx53N",
        "object_type": "deliverable",
        "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
        "envelope_metadata": {
            "deal_id": "50055",
            "deal_owner": "Jane C."
        },
        "deliverable_type": "standard",
        "deliverable_name": null,
        "included_documents": ["contract", "addendum"],
        "url": "https://vault.signatureapi.com/envelopes/eb4cf433-a8af-4161-b37b-7ef57d423e56/deliverables/del_00ZeZjRaXCgT30n1eBx53N/sealed.pdf?Signature=..."
    }
}
```

## deliverable.failed

Fires when deliverable generation fails. The deliverable status is set to `failed`.

Power Automate trigger: [When a deliverable fails](https://signatureapi.com/docs/integrations/power-automate/triggers/deliverable-failed).

The `data.detail` property contains a human-readable explanation of the failure.

> **Note:** Deliverable failures are rare. SignatureAPI support is notified automatically when this event fires.

#### Example payload

```json JSON
{
    "id": "evt_2b3c4d5e6f7g8h9i0j1k",
    "type": "deliverable.failed",
    "timestamp": "2025-12-31T23:59:59.999Z",
    "data": {
        "object_id": "del_00ZeZjRaXCgT30n1eBx53N",
        "object_type": "deliverable",
        "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
        "envelope_metadata": {
            "deal_id": "50055",
            "deal_owner": "Jane C."
        },
        "deliverable_type": "standard",
        "deliverable_name": null,
        "included_documents": ["contract", "addendum"],
        "detail": "The audit log could not be generated due to a system error."
    }
}
```
