---
title: "Retrieve Webhooks configurations"
url: "https://developers.bynder.com/apis/webhooks-api/versions/876c7972-129f-4814-b12a-964ddc49f2b6/operations/getWebhookConfigurations"
---

> Full API specification: https://developers.bynder.com/apis/webhooks-api/versions/876c7972-129f-4814-b12a-964ddc49f2b6.md

# Retrieve Webhooks configurations

`GET` `/v7/webhooks/public/api/subscriptions`

Operation ID: `getWebhookConfigurations`

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

## Responses

- `200` - OK
- `400` - Bad Request

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Webhooks
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
    variables:
      your-bynder-domain:
        default: your-bynder-domainDefaultValue
paths:
  /v7/webhooks/public/api/subscriptions:
    get:
      description: Please be aware that using this endpoint requires either the `View
        Webhooks configurations` or `Manage Webhooks configurations` security
        role.
      operationId: getWebhookConfigurations
      responses:
        "200":
          content:
            application/json:
              examples:
                response:
                  value:
                    antivirusEnabled: true
                    configs:
                      - configId: cf2493be-c808-41da-bcc2-cfb31f38b457
                        confirmed: 1
                        endpoint: example@example.com
                        events:
                          - asset_bank.media.archived
                          - asset_bank.media.pre_archived
                          - asset_bank.media.deleted
                          - asset_bank.media.updated
                          - asset_bank.media.meta_updated
                          - asset_bank.media.create
                          - workflow.job.create
                          - antivirus.scan.failed
                        is_legacy: false
                        migratedSubscriptions: "[]"
                        name: example-webhook-name
                        preArchivedNotificationDays: 1
                        protocol: email
                        status: 1
                    message: ""
                    success: true
              schema:
                example:
                  antivirusEnabled: true
                  configs:
                    - configId: cf2493be-c808-41da-bcc2-cfb31f38b457
                      confirmed: 1
                      endpoint: example@example.com
                      events:
                        - asset_bank.media.archived
                        - asset_bank.media.pre_archived
                        - asset_bank.media.deleted
                        - asset_bank.media.updated
                        - asset_bank.media.meta_updated
                        - asset_bank.media.create
                        - workflow.job.create
                        - antivirus.scan.failed
                      is_legacy: false
                      migratedSubscriptions: "[]"
                      name: example-webhook-name
                      preArchivedNotificationDays: 1
                      protocol: email
                      status: 1
                  message: ""
                  success: true
                properties:
                  antivirusEnabled:
                    type: boolean
                  configs:
                    items:
                      properties:
                        configId:
                          type: string
                        confirmed:
                          type: number
                        endpoint:
                          type: string
                        events:
                          items:
                            type: string
                          type: array
                        is_legacy:
                          type: boolean
                        migratedSubscriptions:
                          type: string
                        name:
                          type: string
                        preArchivedNotificationDays:
                          type: number
                        protocol:
                          type: string
                        status:
                          type: number
                      type: object
                    type: array
                  message:
                    type: string
                  success:
                    type: boolean
                type: object
          description: OK
          headers: {}
        "400":
          content:
            application/json:
              examples:
                response:
                  value:
                    message: "Error while getting subscription for portal id {portal ID}: Error"
                    success: false
              schema:
                example:
                  message: "Error while getting subscription for portal id {portal ID}: Error"
                  success: false
                properties:
                  message:
                    type: string
                  success:
                    type: boolean
                type: object
          description: Bad Request
          headers: {}
      summary: Retrieve Webhooks configurations
      tags:
        - Configurations
```