---
title: "Create On-Call Page"
method: POST
path: "/api/v2/on-call/pages"
tags: ["On-Call Paging"]
---

# Create On-Call Page

`POST /api/v2/on-call/pages`

Trigger a new On-Call Page.

## Request body

- CreatePageRequest — Full request to trigger an On-Call Page.
  - `data` CreatePageRequestData — The main request body, including attributes and resource type.
    - `attributes` CreatePageRequestDataAttributes — Details about the On-Call Page you want to create.
      - `description` string — A short summary of the issue or context.
      - `tags` string[] — Tags to help categorize or filter the page.
      - `target` CreatePageRequestDataAttributesTarget, required — Information about the target to notify (such as a team or user).
        - `identifier` string — Identifier for the target (for example, team handle or user ID).
        - `type` 'team_id' | 'team_handle' | 'user_id' — The kind of target, `team_id` | `team_handle` | `user_id`.
      - `title` string, required — The title of the page.
      - `urgency` 'low' | 'high', required — On-Call Page urgency level.
    - `type` 'pages', required — The type of resource used when creating an On-Call Page.

## Response `200`

OK.

- CreatePageResponse — The full response object after creating a new On-Call Page.
  - `data` CreatePageResponseData — The information returned after successfully creating a page.
    - `id` string — The unique ID of the created page.
    - `type` 'pages', required — The type of resource used when creating an On-Call Page.

## 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)