> ## Documentation Index
> Fetch the complete documentation index at: https://www.composer.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook events

> The event types the Manuscript API can deliver, and the per-document notification configuration a create call accepts.

This page lists the event types the Manuscript API can deliver to a webhook, and the per-document notification object a create call accepts. It is for anyone choosing which events to subscribe a document to.

## Event types

The `DocumentWebhookEvent` enumeration in the Manuscript API document names every event a document can raise. Each row gives the event and the lifecycle stage it belongs to.

| Event                             | Lifecycle                            |
| --------------------------------- | ------------------------------------ |
| `DocumentInReview`                | Document: in review                  |
| `DocumentCompleted`               | Document: completed                  |
| `DocumentArchived`                | Document: archived                   |
| `DocumentUnarchived`              | Document: unarchived                 |
| `DocumentDeleted`                 | Document: deleted                    |
| `WorkflowDocuSignStarted`         | Signature workflow: started          |
| `WorkflowDocuSignCompleted`       | Signature workflow: completed        |
| `WorkflowDocuSignVoided`          | Signature workflow: voided           |
| `WorkflowDocuSignDeclined`        | Signature workflow: declined         |
| `WorkflowDocuSignRecipientUpdate` | Signature workflow: recipient update |

## Per-document notifications

`POST /api/v1/documents` accepts an `eventNotification` object so a single document notifies a chosen URL on chosen events.

| Field        | Type                          | Meaning                                     |
| ------------ | ----------------------------- | ------------------------------------------- |
| `webhookUrl` | string                        | Where deliveries for this document are sent |
| `events`     | array of DocumentWebhookEvent | Which of the event types above to deliver   |

<Info>
  Assessment events are referred to in the Manuscript API's webhook description but are not yet enumerated in its document, and no delivery payload schema is published for any event. Both are open items for the WorkAuthor team (see the gaps register in the engineering repository). Until then, verify every delivery with the [signing rules](/api-reference/manuscript/webhooks) and treat the body as the document's published shape.
</Info>