---
title: "Create a Status Page Post Update"
method: POST
path: "/status_pages/{id}/posts/{post_id}/post_updates"
tags: ["Status Pages"]
---

# Create a Status Page Post Update

`POST /status_pages/{id}/posts/{post_id}/post_updates`

Create a Post Update for a Post by Post ID.

Scoped OAuth requires: `status_pages.write`

## Path parameters

- `id` string, required
- `post_id` string, required

## Headers

- `Accept` string, required

## Request body

- object
  - `post_update` StatusPagePostUpdateRequest, required — Attributes for Post Update creation/update
    - `self` string — The path to which the Post Update resource is accessible.
    - `post` object, required — Status Page Post
      - `id` string, required — Status page post unique identifier
      - `type` string — A string that determines the schema of the object.
    - `message` string, required — The message of the Post Update.
    - `status` object, required — Status Page Status
      - `id` string, required — Status page Status unique identifier
      - `type` string — A string that determines the schema of the object.
    - `severity` object, required — Status Page Severity
      - `id` string, required — Status page Severity unique identifier
      - `type` string — A string that determines the schema of the object.
    - `impacted_services` Items[], required — Impacted services represent the status page services affected by a post update, and its impact. — unresolved $ref
    - `update_frequency_ms` integer, nullable, required — The frequency of the next Post Update in milliseconds.
    - `notify_subscribers` boolean, required — Determines if the subscribers should be notified of the Post Update.
    - `reported_at` string, date-time, nullable — The date and time the Post Update was reported.
    - `type` string, required — The type of the object returned by the API - in this case, a Status Page Post Update.

## Response `201`

Created

- object
  - `post_update` StatusPagePostUpdate — An update for a Post.
    - `id` string — The ID of the Post Update.
    - `self` string — The path to which the Post Update resource is accessible.
    - `post` object — Status Page Post
      - `id` string, required — Status page post unique identifier
      - `type` string — A string that determines the schema of the object.
    - `message` string — The message of the Post Update.
    - `reviewed_status` 'approved' | 'not_reviewed' — The status of the Post Updates to retrieve.
    - `status` object — Status Page Status
      - `id` string, required — Status page Status unique identifier
      - `type` string — A string that determines the schema of the object.
    - `severity` object — Status Page Severity
      - `id` string, required — Status page Severity unique identifier
      - `type` string — A string that determines the schema of the object.
    - `impacted_services` object[] — Impacted services represent the status page services affected by a post update, and its impact.
      - `service` object — Status Page Service
        - `id` string — An unique identifier within Status Page scope that defines a Service entry.
        - `type` string — The type of the object returned by the API - in this case, a Status Page Service.
      - `impact` object — Status Page Impact
        - `id` string — An unique identifier within Status Page scope that defines a Status Page Impact entry.
        - `type` string — The type of the object returned by the API - in this case, a Status Page Impact.
    - `update_frequency_ms` integer, nullable — The frequency of the next Post Update in milliseconds.
    - `notify_subscribers` boolean — Determines if the subscribers should be notified of the Post Update.
    - `reported_at` string, date-time, nullable — The date and time the Post Update was reported.
    - `type` string — The type of the object returned by the API - in this case, a Status Page Post Update.

## Other responses

- `400` — Caller provided invalid arguments. Please review the response for error details. Retrying with the same arguments will *not* work.
- `401` — Caller did not supply credentials or did not provide the correct credentials. If you are using an API key, it may be invalid or your Authorization header may be malformed.
- `403` — Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.
- `404` — The requested resource was not found.
- `429` — Too many requests have been made, the rate limit has been reached.

---

[API](https://skmtc.dev/pagerduty/apis/rest-api.md) · [All operations](https://skmtc.dev/pagerduty/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pagerduty/rest-api/revisions/b679a8f3f02c/schema)