---
title: "Create a new Webhook action"
method: POST
path: "/api/2.0/actions/webhooks"
tags: ["Action Management API"]
---

# Create a new Webhook action

`POST /api/2.0/actions/webhooks`

## Request body

- WebhookActionApi — Action API for Webhook
  - `createdDate` integer — Created date in milliseconds
  - `lastModDate` integer — Last modified date
  - `id` integer — Action ID
  - `userId` integer — Action owner's user ID
  - `actionType` string — Action type
  - `dataFormat` 'attachment' | 'json' — Webhook data format
  - `url` string — Webhook request URL
  - `authUrl` string — Webhook authentication URL
  - `authHeaders` string — Webhook authentication headers
  - `webhookHeaders` string — Webhook request headers
  - `customPostBody` string — Webhook request post body
  - `name` string — Webhook action name

## Response `200`

Success

- WebhookActionApi — Action API for Webhook
  - `createdDate` integer — Created date in milliseconds
  - `lastModDate` integer — Last modified date
  - `id` integer — Action ID
  - `userId` integer — Action owner's user ID
  - `actionType` string — Action type
  - `dataFormat` 'attachment' | 'json' — Webhook data format
  - `url` string — Webhook request URL
  - `authUrl` string — Webhook authentication URL
  - `authHeaders` string — Webhook authentication headers
  - `webhookHeaders` string — Webhook request headers
  - `customPostBody` string — Webhook request post body
  - `name` string — Webhook action name

## Other responses

- `400` — Bad request
- `401` — User is not authenticated
- `500` — Error during processing

---

[API](https://skmtc.net/knowi/apis/user-management-api.md) · [All operations](https://skmtc.net/knowi/apis/user-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/knowi/user-management-api/revisions/6e6982573ba6/schema)