> For the complete documentation index, see [llms.txt](https://dev.isdown.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.isdown.app/endpoints/3rd-party-monitors/add-3rd-party-monitor-to-board.md).

# Add 3rd-party Monitor to Board

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

#### Path Parameters

| Name                                               | Type   | Description                                                                                                                                                 |
| -------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| service\_urlname<mark style="color:red;">\*</mark> | String | Parameterize name for the service. Get the service\_name from the url of a service. E.g., <https://isdown.app/services/digitalocean> it's **digitalocean.** |
| board\_id<mark style="color:red;">\*</mark>        | String | Board Id. Get the identifier for the board in the settings screen.                                                                                          |

#### Body Parameters

| Name | Type           | Description                                                                                                          |
| ---- | -------------- | -------------------------------------------------------------------------------------------------------------------- |
| tags | Array\<String> | Optional. Tags to attach to this service on this board. Whitespace is trimmed; blanks and duplicates are dropped. \| |

#### 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": "383",
        "type": "service",
        "attributes": {
            "name": "unpkg",
            "status": "ok",
            "status_page_url": null,
            "severity_from_provider": false,
            "isdown_url": "https://isdown.app/status/unpkg"
        },
        "tags": [ "tag1", "tag2" ]
    }
}
```

{% 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="404: Not Found When we don't find the resource" %}

```json
{
    "errors": [
        {
            "status": 404,
            "title": "Resource not found",
            "detail": "The resource you are looking for does not exist"
        }
    ]
}
```

{% endtab %}

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

```json
{
    "errors": [
        {
            "status": 422,
            "title": "Unprocessable entity",
            "detail": "Service already added to board"
        }
    ]
}
```

{% endtab %}
{% endtabs %}