---
title: How to set up event delivery (webhooks) for a customer account
description: Send document and delivery events from Qvalia to your own system, per customer account or for your partner account.
---

[Skip to content](https://knowledge.qvalia.com/partner-event-delivery-webhooks#main-content)

- [English](https://knowledge.qvalia.com/partner-event-delivery-webhooks)
- [Svenska](https://knowledge.qvalia.com/sv/partner-event-delivery-webhooks)

English

Show submenu for translations

[![Qvalia Logo New Blue transparent.png\]](https://knowledge.qvalia.com/hs-fs/hubfs/Qvalia%20Logo%20New%20Blue%20transparent.png?height=24&name=Qvalia%20Logo%20New%20Blue%20transparent.png)](https://qvalia.com/)

Open main navigation

Close main navigation

- - [English](https://knowledge.qvalia.com/partner-event-delivery-webhooks)
    - [Svenska](https://knowledge.qvalia.com/sv/partner-event-delivery-webhooks)

  English
  
  Show submenu for translations
- [Go to qvalia.com](https://qvalia.com/pricing/)

[Go to qvalia.com](https://qvalia.com/pricing/)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledge base](https://knowledge.qvalia.com/?hsLang=en)
2. [Partner](https://knowledge.qvalia.com/partner?hsLang=en)

# How to set up event delivery (webhooks) for a customer account

## Event delivery sends document and delivery events from Qvalia to your own system as they happen. Set it up per customer account, or for your partner account.

Your endpoint gets a call when a document arrives or its delivery status changes. You set it up in two steps.

### Step 1: Event subscription

1. In the partner dashboard, open the company and go to Webhooks.
2. Enter the Endpoint URL. It must use HTTPS and return a 2xx response within 10 seconds, or the delivery attempt is treated as failed.
3. Choose at least one event type.
4. Select Create signing key if you want to verify that each delivery comes from Qvalia. The key is shown once, after saving, so store it right away.
5. Select Save and continue.

Event type

Sent when

New document

A new document arrives for the company

Delivery status changed

A document's delivery status is updated

Delivery delayed

Delivery is taking longer than expected

Delivery failed

A document could not be delivered

### Step 2: Outbound authentication

Choose how Qvalia authenticates when it calls your endpoint.

Method

How it works

OAuth 2.0 (recommended)

Client credentials grant. Qvalia fetches a short-lived token.

API key

A static key sent in a request header. The header name is optional and defaults to Authorization.

Basic auth

Username and password on every request.

Saved credentials are never shown again. To change them, enter new values; they replace the saved ones.

### Event delivery for your partner account

To receive events for the partner account itself, select the gear icon in the top right corner and go to Webhooks. The setup is the same.

### Related articles

- [How to add and manage customer accounts in the partner dashboard](https://knowledge.qvalia.com/partner-dashboard-customer-accounts?hsLang=en)
- [Getting started with the Qvalia API](https://knowledge.qvalia.com/how-to-integrate-qvalia-to-erp-systems?hsLang=en)

- [General](https://knowledge.qvalia.com/general?hsLang=en#main-content)

    - [Peppol](https://knowledge.qvalia.com/general?hsLang=en#peppol)
- [Partner](https://knowledge.qvalia.com/partner?hsLang=en)
- [Logs and monitoring](https://knowledge.qvalia.com/logs-and-monitoring?hsLang=en)
- [Integrations](https://knowledge.qvalia.com/integrations?hsLang=en)
- [Invoice management](https://knowledge.qvalia.com/invoice-management?hsLang=en)
- [Order management](https://knowledge.qvalia.com/order-management?hsLang=en)
- [Data management](https://knowledge.qvalia.com/data-management?hsLang=en)
- [Security and compliance](https://knowledge.qvalia.com/security-and-compliance?hsLang=en)
- [Account](https://knowledge.qvalia.com/account?hsLang=en)
- [Troubleshooting](https://knowledge.qvalia.com/troubleshooting?hsLang=en)

[![Chill listening crop-3](https://knowledge.qvalia.com/hs-fs/hubfs/Qvalia%20Logo%20New%20Blue%20transparent.png?width=107&height=24&name=Qvalia%20Logo%20New%20Blue%20transparent.png "Chill listening crop-3")](https://qvalia.com/)

Knowledge base

Copyright © 2025, Qvalia