---
title: "Create a Statuspage URL setting"
method: POST
path: "/api/v2/integration/statuspage/url_settings"
tags: ["Statuspage Integration"]
---

# Create a Statuspage URL setting

`POST /api/v2/integration/statuspage/url_settings`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/integration/statuspage/url_settings`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Create a Statuspage URL setting for your organization.

## Request body

- StatuspageUrlSettingCreateRequest: Create request for a Statuspage URL setting.
  - `data` StatuspageUrlSettingCreateData, required: Statuspage URL setting data for a create request.
    - `attributes` StatuspageUrlSettingCreateAttributes, required: The Statuspage URL setting attributes for a create request.
      - `custom_tags` string, required: Comma-separated list of custom tags to apply to events generated from this Statuspage URL.
      - `url` string, required: The Statuspage URL to monitor. Must be a `status.io` or `statuspage.com` URL.
    - `type` 'statuspage-url-setting', required: Statuspage URL setting resource type.

## Response `201`

CREATED

- StatuspageUrlSettingResponse: Response containing a Statuspage URL setting.
  - `data` StatuspageUrlSettingResponseData, required: Statuspage URL setting data from a response.
    - `attributes` StatuspageUrlSettingResponseAttributes, required: The attributes from a Statuspage URL setting response.
      - `custom_tags` string: Comma-separated list of custom tags applied to events generated from this Statuspage URL.
      - `url` string: The Statuspage URL being monitored.
    - `id` string, required: The ID of the Statuspage URL setting.
    - `type` 'statuspage-url-setting', required: Statuspage URL setting resource type.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `409`: Conflict
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)