# Create a subscription

**POST /rest/ws/webhooks/v1/subscriptions**

Creates a new webhook subscription for specified event types.


## Servers
- The node of your Praxedo instance (eu1, am1...).: https://ws-eu1.praxedo.com (The node of your Praxedo instance (eu1, am1...).)


## Authentication methods
- Bearer authentication


## Parameters



### Body: application/json (object)
Request payload to create a webhook subscription.
- **callback** (object)

- **eventTypes** (array[object])
  List of event types the subscription should listen to.



## Responses
### 201
Subscription successfully created

#### Body: application/json (object)
- **id** (string)
  the id of the created subscription

- **eventTypes** (array[object])


### 400
The subscription creation request is not correctly formatted.
Subscription not created.

#### Body: application/json (object)
- **errors** (array[object])
  Array of errors. Contains at least one element.

- **errorReference** (string)
  Error unique reference. Communicated to support, this will help to locate the issue.


### 401
Unauthorized - authentication issue.

#### Body: application/json (object)
- **errors** (array[object])
  Array of errors. Contains at least one element.

- **errorReference** (string)
  Error unique reference. Communicated to support, this will help to locate the issue.


### 422
Syntax is correct, but unable to create the given subscription.
Subscription not created.


#### Body: application/json (object)
- **errors** (array[object])
  Array of errors. Contains at least one element.

- **errorReference** (string)
  Error unique reference. Communicated to support, this will help to locate the issue.


### 429
Too Many Requests.

#### Body: application/json (object)
- **errors** (array[object])
  Array of errors. Contains at least one element.

- **errorReference** (string)
  Error unique reference. Communicated to support, this will help to locate the issue.


### 500
Internal server error.

#### Body: application/json (object)
- **errors** (array[object])
  Array of errors. Contains at least one element.

- **errorReference** (string)
  Error unique reference. Communicated to support, this will help to locate the issue.



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