---
title: "Subscribe new webhook"
method: POST
path: "/v1/integrations/webhooks/subscribe"
---

# Subscribe new webhook

`POST /v1/integrations/webhooks/subscribe`

## Request

- Base URL: `https://api.hystruct.com`
- URL: `https://api.hystruct.com/v1/integrations/webhooks/subscribe`
- Auth: API key in header `x-api-key`

Create and subscribe a new webhook

## Request body

- object
  - `workflowId` string, required: workflow ID
  - `webhookUrl` string, required: Webhook URL
  - `events` unknown[], required: The events to subscribe to
    - unknown

## Response `200`

Successful response

- object: Successful response
  - `message` string

## Other responses

- `400`: Bad request
- `404`: No workflow found

---

[API](https://skmtc.dev/hystruct/apis/hystruct-api.md) · [All operations](https://skmtc.dev/hystruct/apis/hystruct-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hystruct/apis/hystruct-api/revisions/29f66c13ba02?raw)