For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/on-call-paging/create-on-call-page.md. A documentation index is available at /llms.txt.
Language
Datadog site

Create On-Call Page

POSThttps://navy.oncall.datadoghq.com/api/v2/on-call/pageshttps://teal.oncall.datadoghq.com/api/v2/on-call/pageshttps://coral.oncall.datadoghq.com/api/v2/on-call/pageshttps://beige.oncall.datadoghq.eu/api/v2/on-call/pageshttps://saffron.oncall.datadoghq.com/api/v2/on-call/pageshttps://lava.oncall.datadoghq.com/api/v2/on-call/pageshttps://scarlet.oncall.datadoghq.com/api/v2/on-call/pageshttps://navy.oncall.datadoghq.com/api/v2/on-call/pageshttps://navy.oncall.datadoghq.com/api/v2/on-call/pages

Overview

Trigger a new On-Call Page.

Request

Body Data (required)

Field
Type
Description
data
object

The main request body, including attributes and resource type.

Response

OK.

The full response object after creating a new On-Call Page.

Field
Type
Description
data
object

The information returned after successfully creating a page.

Code Example

Create On-Call Page
# Set your Datadog credentials
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://navy.oncall.datadoghq.com/api/v2/on-call/pages" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Page details.",
      "tags": [
        "service:test"
      ],
      "target": {
        "identifier": "my-team",
        "type": "team_handle"
      },
      "title": "Page title",
      "urgency": "low"
    },
    "type": "pages"
  }
}
EOF
# Set your Datadog credentials
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://teal.oncall.datadoghq.com/api/v2/on-call/pages" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Page details.",
      "tags": [
        "service:test"
      ],
      "target": {
        "identifier": "my-team",
        "type": "team_handle"
      },
      "title": "Page title",
      "urgency": "low"
    },
    "type": "pages"
  }
}
EOF
# Set your Datadog credentials
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://coral.oncall.datadoghq.com/api/v2/on-call/pages" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Page details.",
      "tags": [
        "service:test"
      ],
      "target": {
        "identifier": "my-team",
        "type": "team_handle"
      },
      "title": "Page title",
      "urgency": "low"
    },
    "type": "pages"
  }
}
EOF
# Set your Datadog credentials
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://beige.oncall.datadoghq.eu/api/v2/on-call/pages" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Page details.",
      "tags": [
        "service:test"
      ],
      "target": {
        "identifier": "my-team",
        "type": "team_handle"
      },
      "title": "Page title",
      "urgency": "low"
    },
    "type": "pages"
  }
}
EOF
# Set your Datadog credentials
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://saffron.oncall.datadoghq.com/api/v2/on-call/pages" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Page details.",
      "tags": [
        "service:test"
      ],
      "target": {
        "identifier": "my-team",
        "type": "team_handle"
      },
      "title": "Page title",
      "urgency": "low"
    },
    "type": "pages"
  }
}
EOF
# Set your Datadog credentials
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://lava.oncall.datadoghq.com/api/v2/on-call/pages" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Page details.",
      "tags": [
        "service:test"
      ],
      "target": {
        "identifier": "my-team",
        "type": "team_handle"
      },
      "title": "Page title",
      "urgency": "low"
    },
    "type": "pages"
  }
}
EOF
# Set your Datadog credentials
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://scarlet.oncall.datadoghq.com/api/v2/on-call/pages" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Page details.",
      "tags": [
        "service:test"
      ],
      "target": {
        "identifier": "my-team",
        "type": "team_handle"
      },
      "title": "Page title",
      "urgency": "low"
    },
    "type": "pages"
  }
}
EOF
# Set your Datadog credentials
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://navy.oncall.datadoghq.com/api/v2/on-call/pages" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Page details.",
      "tags": [
        "service:test"
      ],
      "target": {
        "identifier": "my-team",
        "type": "team_handle"
      },
      "title": "Page title",
      "urgency": "low"
    },
    "type": "pages"
  }
}
EOF
# Set your Datadog credentials
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://navy.oncall.datadoghq.com/api/v2/on-call/pages" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Page details.",
      "tags": [
        "service:test"
      ],
      "target": {
        "identifier": "my-team",
        "type": "team_handle"
      },
      "title": "Page title",
      "urgency": "low"
    },
    "type": "pages"
  }
}
EOF