---
title: "Add a webhook"
method: POST
path: "/v1/workspaces/{workspace_id}/webhooks"
tags: ["Webhooks"]
---

# Add a webhook

`POST /v1/workspaces/{workspace_id}/webhooks`

## Request

- Base URL: `https://api.oxvo.com`
- URL: `https://api.oxvo.com/v1/workspaces/{workspace_id}/webhooks`
- Auth: API key in header `api_access_token`

Add a webhook subscription to the account

## Path parameters

- `workspace_id` integer, required

## Request body

- WebhookCreateUpdatePayload
  - `url` string: The url where the events should be sent
  - `name` string: The name of the webhook
  - `subscriptions` string[]: The events you want to subscribe to.

## Response `200`

Success

- Webhook
  - `id` number: The ID of the webhook
  - `url` string: The url to which the events will be send
  - `name` string: The name of the webhook
  - `subscriptions` string[]: The list of subscribed events
  - `account_id` number: The id of the account which the webhook object belongs to

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/oxvo/apis/oxvo-apis.md) · [All operations](https://skmtc.dev/oxvo/apis/oxvo-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/oxvo/apis/oxvo-apis/revisions/9a8448cbd1fe?raw)