---
title: "Create status page"
method: POST
path: "/api/v2/statuspages"
tags: ["Status Pages"]
---

# Create status page

`POST /api/v2/statuspages`

Creates a new status page in an unpublished state. Use the dedicated [publish](#publish-status-page) status page endpoint to publish the page after creation.

## Query parameters

- `include` string

## Request body

- CreateStatusPageRequest — Request object for creating a status page.
  - `data` CreateStatusPageRequestData — The data object for creating a status page.
    - `attributes` CreateStatusPageRequestDataAttributes, required — The supported attributes for creating a status page.
      - `company_logo` string — The base64-encoded image data displayed on the status page.
      - `components` CreateStatusPageRequestDataAttributesComponentsItems[] — The components displayed on the status page.
        - `components` CreateStatusPageRequestDataAttributesComponentsItemsComponentsItems[] — If creating a component of type `group`, the components to create within the group.
          - `id` string, uuid — The ID of the grouped component.
          - `name` string — The name of the grouped component.
          - `position` integer — The zero-indexed position of the grouped component. Relative to the other components in the group.
          - `status` 'operational' | 'degraded' | 'partial_outage' | 'major_outage' | 'maintenance' — The status of the component.
          - `type` 'component' — The type of the component.
        - `id` string, uuid — The ID of the component.
        - `name` string — The name of the component.
        - `position` integer — The zero-indexed position of the component.
        - `status` 'operational' | 'degraded' | 'partial_outage' | 'major_outage' | 'maintenance' — The status of the component.
        - `type` 'component' | 'group' — The type of the component.
      - `domain_prefix` string, required — The subdomain of the status page's url taking the form `https://{domain_prefix}.statuspage.datadoghq.com`. Globally unique across Datadog Status Pages.
      - `email_header_image` string — Base64-encoded image data included in email notifications sent to status page subscribers.
      - `enabled` boolean — Whether the status page is enabled.
      - `favicon` string — Base64-encoded image data displayed in the browser tab.
      - `name` string, required — The name of the status page.
      - `slack_app_icon` string — The Slack app icon URL for the status page.
      - `slack_subscriptions_enabled` boolean — Whether Slack subscriptions are enabled for the status page.
      - `subscriptions_enabled` boolean — Whether users can subscribe to the status page.
      - `type` 'public' | 'internal', required — The type of the status page controlling how the status page is accessed.
      - `visualization_type` 'bars_and_uptime_percentage' | 'bars_only' | 'component_name_only', required — The visualization type of the status page.
    - `type` 'status_pages', required — Status pages resource type.

## Response `201`

Created

- StatusPage — Response object for a single status page.
  - `data` StatusPageData — The data object for a status page.
    - `attributes` StatusPageDataAttributes — The attributes of a status page.
      - `company_logo` string, nullable — Base64-encoded image data displayed on the status page.
      - `components` StatusPageDataAttributesComponentsItems[] — Components displayed on the status page.
        - `components` StatusPageDataAttributesComponentsItemsComponentsItems[] — If the component is of type `group`, the components within the group.
          - `id` string, uuid — The ID of the component.
          - `name` string — The name of the component.
          - `position` integer — The zero-indexed position of the component. Relative to the other components in the group.
          - `status` 'operational' | 'degraded' | 'partial_outage' | 'major_outage' | 'maintenance' — The status of the component.
          - `type` 'component' — The type of the component.
        - `id` string, uuid — The ID of the component.
        - `name` string — The name of the component.
        - `position` integer — The zero-indexed position of the component.
        - `status` 'operational' | 'degraded' | 'partial_outage' | 'major_outage' | 'maintenance' — The status of the component.
        - `type` 'component' | 'group' — The type of the component.
      - `created_at` string, date-time — Timestamp of when the status page was created.
      - `custom_domain` string, nullable — If configured, the url that the status page is accessible at.
      - `custom_domain_enabled` boolean — Whether the custom domain is configured.
      - `domain_prefix` string — The subdomain of the status page's url taking the form `https://{domain_prefix}.statuspage.datadoghq.com`. Globally unique across Datadog Status Pages.
      - `email_header_image` string, nullable — Base64-encoded image data included in email notifications sent to status page subscribers.
      - `enabled` boolean — Whether the status page is enabled.
      - `favicon` string, nullable — Base64-encoded image data displayed in the browser tab.
      - `modified_at` string, date-time — Timestamp of when the status page was last modified.
      - `name` string — The name of the status page.
      - `page_url` string — The url that the status page is accessible at.
      - `slack_app_icon` string — The Slack app icon URL for the status page.
      - `slack_subscriptions_enabled` boolean — Whether Slack subscriptions are enabled for the status page.
      - `subscriptions_enabled` boolean — Whether users can subscribe to the status page.
      - `type` 'public' | 'internal' — The type of the status page controlling how the status page is accessed.
      - `visualization_type` 'bars_and_uptime_percentage' | 'bars_only' | 'component_name_only' — The visualization type of the status page.
    - `id` string, uuid — The ID of the status page.
    - `relationships` StatusPageDataRelationships — The relationships of a status page.
      - `created_by_user` StatusPageDataRelationshipsCreatedByUser — The Datadog user who created the status page.
        - `data` StatusPageDataRelationshipsCreatedByUserData, required — The data object identifying the Datadog user who created the status page.
          - `id` string, required — The ID of the Datadog user who created the status page.
          - `type` 'users', required — Users resource type.
      - `last_modified_by_user` StatusPageDataRelationshipsLastModifiedByUser — The Datadog user who last modified the status page.
        - `data` StatusPageDataRelationshipsLastModifiedByUserData, required — The data object identifying the Datadog user who last modified the status page.
          - `id` string, required — The ID of the Datadog user who last modified the status page.
          - `type` 'users', required — Users resource type.
    - `type` 'status_pages', required — Status pages resource type.
  - `included` StatusPageArrayIncluded[] — The included related resources of a status page. Client must explicitly request these resources by name in the `include` query parameter.
    - `attributes` StatusPagesUserAttributes — Attributes of the Datadog user.
      - `email` string — The email of the Datadog user.
      - `handle` string — The handle of the Datadog user.
      - `icon` string — The icon of the Datadog user.
      - `name` string — The name of the Datadog user.
      - `uuid` string — The UUID of the Datadog user.
    - `id` string, uuid — The ID of the Datadog user.
    - `type` 'users', required — Users resource type.

## Other responses

- `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/revisions/da68bf029e4c/schema)