---
title: "Create a Webhook configuration"
method: POST
path: "/v7/webhooks/public/api/subscriptions"
tags: ["Configurations"]
---

# Create a Webhook configuration

`POST /v7/webhooks/public/api/subscriptions`

Please be aware that using this endpoint requires the `Manage Webhooks configurations` security role.

## Request body

- object
  - `endpoint` string, required — Endpoint for the Webhooks subscription.
  - `events` unknown[], required — List of events to subscribe to.
    - unknown
  - `name` string, required — Display name for the Webhooks configuration.
  - `preArchivedNotificationDays` number — Required to have a value of 1 or greater if the "asset_bank.media.pre_archived" event is subscribed to
  - `protocol` string, required — Protocol for the Webhooks subscription. Possible values: "http", "https", "email", "email-json", "sqs".

## Response `200`

OK

- object
  - `message` string
  - `record` object
    - `configId` string
    - `endpoint` string
    - `events` string[]
    - `is_legacy` boolean
    - `migratedSubscriptions` string
    - `name` string
    - `portalId` string
    - `preArchivedNotificationDays` number
    - `protocol` string
    - `subscriptionArn` string
    - `topicArn` string
    - `userId` string
  - `success` boolean

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/bynder/apis/oauth-2-0.md) · [All operations](https://skmtc.net/bynder/apis/oauth-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bynder/oauth-2-0/revisions/bb9efc864ce1/schema)