# Create Board

<mark style="color:orange;">`POST`</mark> `https://isdown.app/api/v2/boards`

#### Path Parameters

| Name                                   | Type   | Description       |
| -------------------------------------- | ------ | ----------------- |
| name<mark style="color:red;">\*</mark> | String | Name of the board |

#### Headers

| Name                                            | Type   | Description     |
| ----------------------------------------------- | ------ | --------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer API\_KEY |

{% tabs %}
{% tab title="200: OK When status is OK" %}

```json
{
    "data": {
        "id": "XXXXX-XXXX-XXXX-XXXXXXXX",
        "type": "board",
        "attributes": {
            "name": "Test Board via API",
            "urlname": "test-board-via-api",
            "services": []
        }
    }
}
```

{% endtab %}

{% tab title="401: Unauthorized When authorization is missing or is invalid" %}

```json
{
    "errors": [
        {
            "status": 401,
            "title": "Unauthorized access",
            "detail": "You are not authorized to access this resource"
        }
    ]
}
```

{% endtab %}

{% tab title="422: When service already exists in the board" %}

```json
{
    "errors": [
        {
            "status": 422,
            "title": "Unprocessable entity",
            "detail": "Board limit reached for your plan"
        }
    ]
}
```

{% endtab %}
{% endtabs %}