---
title: "Create webhook"
method: POST
path: "/api/sites/multiscreen/webhooks"
tags: ["Partner webhooks API"]
---

# Create webhook

`POST /api/sites/multiscreen/webhooks`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/sites/multiscreen/webhooks`
- Auth: HTTP basic

Registers a new webhook for the given endpoint, event types, and resource, and returns the created webhook.

## Request body

- PartnerApiCreateWebhookRequest
  - `endpoint` string, required
  - `event_types` string[], required
  - `external_id` string: Customer-provided webhook identifier
  - `resource_id` string
  - `resource_type` 'SITE' | 'ACCOUNT', required

## Response `200`

OK

- PartnerApiWebhookResponse
  - `active` boolean
  - `endpoint` string
  - `event_types` string[]
  - `external_id` string
  - `id` integer
  - `resource` WebhookResource
    - `resourceId` string
    - `type` 'SITE' | 'ACCOUNT' | 'PRODUCT'

## Other responses

- `400`: Bad request. The request is malformed or failed validation.
- `401`: Unauthorized. The credentials are missing or invalid.
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)