---
title: "Create an on-call page from an incident"
method: POST
path: "/api/v2/incidents/{incident_id}/page"
tags: ["Incidents"]
---

# Create an on-call page from an incident

`POST /api/v2/incidents/{incident_id}/page`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/incidents/{incident_id}/page`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `incident_write`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/incidents/:incident_id/page/post.ts> (a function with typed inputs; its response is checked against the schema)

Create an on-call page directly from an incident.

## Path parameters

- `incident_id` string, required

## Request body

- IncidentCreateOnCallPageRequest: Request payload for creating an on-call page from an incident.
  - `data` IncidentCreateOnCallPageDataRequest, required: On-call page data in a create request.
    - `attributes` IncidentCreateOnCallPageDataAttributesRequest, required: Attributes for creating an on-call page from an incident.
      - `description` string: The description of the page.
      - `role` IncidentPageRoleReference: A reference to an incident role for a page.
        - `id` string, uuid, required: The role identifier.
        - `type` 'incident_user_defined_roles' | 'incident_reserved_roles', required: The type of incident role for a page.
      - `services` string[]: List of affected services.
      - `tags` string[]: List of tags for the page.
      - `target` IncidentPageTarget: The target recipient for a page.
        - `identifier` string, required: The identifier of the target (handle, UUID, or user UUID).
        - `type` 'team_handle' | 'team_uuid' | 'user_uuid', required: The type of target for a page request.
      - `title` string: The title of the page.
    - `type` 'page', required: Resource type for a page creation request.

## Response `200`

OK

- IncidentPageUUIDResponse: Response with a page UUID.
  - `data` IncidentPageUUIDDataResponse, required: Page UUID data in a response.
    - `id` string, uuid, required: The UUID of the created page.
    - `type` 'page_uuid', required: Resource type for a page UUID response.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `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/3f70db624329?raw)