# Webhooks

Source: https://www.digiparser.com/docs/api/webhooks

# Webhooks

Receive document.exported events and payload structure

Copy MarkdownOpen

# [Webhooks](#webhooks)

Feedback

Webhooks send extracted data to your URLs when a document is processed.

## [Setting up webhooks](#setting-up-webhooks)

Feedback

1.  Open your parser and go to **Settings -> Integrations**.
2.  Under **Available Integrations**, click **Webhook**.
3.  Expand **Webhook export**, add one or more **endpoint URLs**, then click **Save**.

## [Event type: document.exported](#event-type-documentexported)

Feedback

Triggered when a document has been extracted, post-processed, and (if reviews are enabled) approved. Requests are delivered by **Svix**. The request body is JSON with this shape:

```
{
  "extracted_data": {
    "Invoice Number": "INV-001",
    "Total": "1,234.56",
    "Date": "2024-01-15"
  },
  "metadata": {
    "id": "doc_123",
    "name": "Invoice INV-001",
    "url": "https://app.digiparser.com/document/doc_123",
    "isProcessed": true,
    "assignee": null,
    "event": "document.exported",
    "teamId": "team_123",
    "teamSlug": "acme-co",
    "parserId": "parser_123",
    "workflowId": "workflow_123"
  }
}
```

Feedback

*   **extracted\_data** - Your parser's fields (and tables) as key-value pairs. Keys match your field names; values are strings.
*   **metadata** - Document and context: `id`, `name`, `url`, `isProcessed`, `assignee`, `event`, `teamId`, `teamSlug`, `parserId`, `workflowId`.

## [Webhook security](#webhook-security)

### [Signature verification](#signature-verification)

Feedback

Each request includes Svix headers you can use to verify it came from DigiParser and was not modified:

```
svix-id: ...
svix-timestamp: ...
svix-signature: ...
```

Feedback

Use these with the **signing secret** shown for each endpoint in the Webhook export settings. See [How to verify webhooks](/docs/guides/integrations/verifying-webhooks) for details and code samples.

### [HTTPS](#https)

Feedback

Webhook URLs must use HTTPS.

## [Testing webhooks](#testing-webhooks)

Feedback

In **Settings -> Integrations -> Webhook export**, expand an endpoint and use **Send test webhook** to send a sample payload to your URL.

How is this guide?

GoodBad

[

Authentication

How to authenticate API requests

](/docs/api/authentication)[

Delete Documents POST

Delete documents so their \`externalId\` values can be reused on re-upload. \*\*Request body:\*\* Provide \`documentIds\` and/or \`externalIds\`. - If you send \`documentIds\`, \`externalIds\` is optional. - If you send \`externalIds\`, \`documentIds\` is optional. - You must provide at least one of them.

](/docs/api/deleteDocuments)