---
title: "Add Webhook Subscription"
method: POST
path: "/business/v2/webhooks/subscriptions"
tags: ["Webhook Subscriptions"]
---

# Add Webhook Subscription

`POST /business/v2/webhooks/subscriptions`

Endpoint to add a new `WebhookSubscription`.

## Headers

- `X-Soldo-Fingerprint` string, required — [Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.
- `X-Soldo-Fingerprint-Signature` string, required — [Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.

## Request body

- CreateWebhookSubscription — Create `WebhookSubscription` JSON parameters.
  - `webhook_url` string, required — The url of the `WebhookSubscription`.
  - `enabled_events` WebhookEventName[], required — The list of the `WebhookSubscription` enabled events.
  - `description` string — The description of the `WebhookSubscription`.
  - `active` boolean, required — The status of the `WebhookSubscription` (if `false`, notifications are not sent).

## Response `200`

The returned resource is a single `WebhookSubscription`.

- WebhookSubscription
  - `id` string, uuid — The `WebhookSubscription` ID.
  - `webhook_url` string — The URL of `WebhookSubscription`.
  - `enabled_events` WebhookEventName[] — The list of subscribed events.
  - `description` string — A custom description of the `WebhookSubscription`.
  - `active` boolean — The status of the `WebhookSubscription`.
  - `creation_date` string — The date and time when the `WebhookSubscription` was created (sortable: yes).
  - `last_update` string — The last date and time when the `WebhookSubscription` was last updated (sortable: yes).

## Other responses

- `400` — Your request has missing arguments or is malformed.

---

[API](https://skmtc.net/soldo/apis/soldo-business-api-v2-0.md) · [All operations](https://skmtc.net/soldo/apis/soldo-business-api-v2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/soldo/soldo-business-api-v2-0/versions/7be21448a2b3/schema)