---
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`

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.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)