# Subscribe to a webhook

**POST /webhook/createSubscription**




## Servers
- Production server: https://public-api.joinswsh.com (Production server)


## Authentication methods
- Api key auth


## Parameters



### Body: application/json (object)

- **event** (string)
  The event subscribed to.
- **targetUrl** (string)
  The URL to send the webhook to. Must be a valid HTTPS URL.
- **metadata** (object)
  Additional metadata included in the webhook request. This can be used to pass custom data to the webhook handler. Valid value types are string, number, and boolean.
- **albumId** (string)



## Responses
### 200
Webhook subscription created successfully

#### Body: application/json (object)
- **data** (object)

- **warnings** (array[string])


### 400
Invalid request. The request was malformed or missing required parameters.

#### Body: application/json (object)
- **message** (string)


### 403
Forbidden. The caller does not have permission to perform this action.

#### Body: application/json (object)
- **message** (string)



[Powered by Bump.sh](https://bump.sh)