---
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`

## Request

- Base URL: `https://your-bynder-domainDefaultValue`
- URL: `https://your-bynder-domainDefaultValue/v7/webhooks/public/api/subscriptions`
- Auth: none declared

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.dev/bynder/apis/webhooks-api.md) - [All operations](https://skmtc.dev/bynder/apis/webhooks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/webhooks-api/revisions/49e636e53904?raw)