# Create Widget

This method allows the creation of the [widget](https://docs.pulsoid.net/widgets-management/widget-entity).

**Request**

<table><thead><tr><th width="213">name</th><th>value</th></tr></thead><tbody><tr><td>url</td><td><code>https://dev.pulsoid.net/api/v1/widgets</code></td></tr><tr><td>method</td><td><code>POST</code></td></tr><tr><td>scope</td><td><code>widgets:update</code></td></tr></tbody></table>

**Body Param** Accepts JSON object with the following fields

<table><thead><tr><th width="164">name</th><th>value</th></tr></thead><tbody><tr><td>configuration</td><td>Json representing new widget's configuration</td></tr><tr><td>name</td><td>Name of the widget</td></tr><tr><td>meta_id</td><td>Currently only basic bpm is supported so the value should be hardcoded to <code>bf6bdf21-10a7-4a28-97ec-a239e6c77f8b</code></td></tr></tbody></table>

**Headers Parameters explained:**

<table><thead><tr><th width="165">name</th><th>value</th><th>description</th></tr></thead><tbody><tr><td>Authorization</td><td>Bearer {auth token}</td><td>How to obtains access token<br><a href="https://docs.pulsoid.net/#how-to-obtain-an-authorization-token">https://docs.pulsoid.net/#how-to-obtain-an-authorization-token</a></td></tr></tbody></table>

**Response**

The response is a created [widget](https://docs.pulsoid.net/widgets-management/widget-entity).

**Curl Request Example**

```bash
curl --request POST \
  --url https://pulsoid.net/api/v1/widgets \
  --header 'Authorization: Bearer 47ee2a9f-624d-4ed3-84db-8104b229f21c' \
  --header 'Content-Type: application/json' \
  --data '{
  "meta_id": "bf6bdf21-10a7-4a28-97ec-a239e6c77f8b",
  "name": "Test",
  "configuration": {
    "heartEnabled": false
  }
}'
```

**Response Example**

```json
{
  "widget": {
    "id": "a9b9768c-b907-40b7-9530-ae515d8df6b0",
    "meta_id": "bf6bdf21-10a7-4a28-97ec-a239e6c77f8b",
    "configuration": {
      "heartEnabled": false
    },
    "name": "Test"
  }
}
```

***