Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Sending alerts to Slack ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Advanced guide
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Uptime API
    1. Getting an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
      1. On-call schedule
      2. On-call schedule events
      3. On-call schedule rotations
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
      7. Severity groups
      8. Incidents
      9. Comments
        1. List comments GET
        2. Get comment GET
        3. Create comment POST
        4. Update comment PATCH
        5. Remove comment DELETE
    5. Status pages
    6. Metadata
    7. Integrations

Create comment

This will create a new comment.

POST https://uptime.betterstack.com/api/v2/incidents/{incident_id}/comments

URL parameters

incident_id
required string

The ID of the incident

Headers

Authorization
required string

Bearer $TOKEN

Content_Type
string

application/json

Body parameters

content
required string

The content of the comment. Markdown is supported for formatting.

201

The comment was successfully created

Response body

{
  "data": {
    "id": "123",
    "type": "incident_comment",
    "attributes": {
      "id": 123,
      "content": "posted from API",
      "created_at": "2025-06-03T12:10:28.357Z",
      "updated_at": "2025-06-03T12:10:28.357Z"
    }
  }
}
403

Authentication failed

Example cURL

Simple text Rich-formatted comment 
curl --request POST \
  --url https://uptime.betterstack.com/api/v2/incidents/1/comments \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"content": "Posted from API"}'
curl --request POST \
  --url https://uptime.betterstack.com/api/v2/incidents/1/comments \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "content": "# 🚨 Incident Update\n\nHere is the current system status:\n\n| Component | Status       |\n|-----------|--------------|\n| API       | ✅ Operational |\n| Database  | 🔄 Restarting |\n| Cache     | ❌ Down       |\n\n_Updated automatically via API._"
  }'

Previous article

Get comment

Next article

Update comment