---
title: "Create On-Call Page comment"
method: POST
path: "/api/v2/on-call/pages/{page_id}/comments"
tags: ["On-Call"]
---

# Create On-Call Page comment

`POST /api/v2/on-call/pages/{page_id}/comments`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/on-call/pages/{page_id}/comments`
- 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`

Add a comment to the timeline of an On-Call Page.

## Path parameters

- `page_id` string, required

## Request body

- CreateOnCallPageCommentRequest: Request to create a comment on an On-Call Page.
  - `data` CreateOnCallPageCommentRequestData, required: Data for creating a comment on an On-Call Page.
    - `attributes` CreateOnCallPageCommentRequestAttributes, required: Attributes for creating a comment on an On-Call Page.
      - `body` string, required: The content of the comment.
      - `mentioned_user_ids` string[]: The IDs of the users mentioned in the comment.
    - `id` string, uuid: A client-generated UUID that makes the request idempotent. Retrying the request with the same ID does not create a duplicate comment. If you omit the ID, Datadog generates a random ID.
    - `type` 'comments', required: Indicates that the resource is of type `comments`.

## Response `204`

No Content

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

## Changes

- **2026-11-17** `fb77f3bfe6e1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/changes/api/v2/on-call/pages/:page_id/comments/post.md)

---

[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/8d1a5e5973da?raw)
