---
title: "Create Notification Webhook"
method: POST
path: "/api/notification_webhooks/deployments/{deploymentId}/webhooks"
tags: ["NotificationWebhooksService"]
---

# Create Notification Webhook

`POST /api/notification_webhooks/deployments/{deploymentId}/webhooks`

Create a new webhook endpoint.

## Path parameters

- `deploymentId` string, required

## Request body

- ProtosNotificationWebhooksV1CreateNotificationWebhookRequest
  - `deploymentId` string
  - `name` string — The user-specified name for the webhook
  - `url` string — The URL endpoint where webhook payloads will be sent
  - `useNetworkBroker` boolean — Whether to use the network broker for webhook delivery
  - `webhookSecret` string — Optional webhook secret for request signing

## Response `200`

OK

- ProtosNotificationWebhooksV1CreateNotificationWebhookResponse
  - `webhook` ProtosNotificationWebhooksV1NotificationWebhook
    - `id` string — The notification webhook ID
    - `name` string — The user-specified name for the webhook
    - `url` string — The URL endpoint where webhook payloads will be sent
    - `hasSecret` boolean — Whether the webhook has a secret configured (actual secret never exposed)
    - `useNetworkBroker` boolean — Whether to use the network broker for webhook delivery

---

[API](https://skmtc.net/semgrep/apis/semgrep-web-app.md) · [All operations](https://skmtc.net/semgrep/apis/semgrep-web-app/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/semgrep/semgrep-web-app/versions/6483eeecd582/schema)