---
title: "Creates a new contact"
method: POST
path: "/alerting/contacts"
tags: ["Contacts"]
---

# Creates a new contact

`POST /alerting/contacts`

Creates a new contact with at least one contact method (notification target)

## Request body

- CreateContact
  - `name` string, required — Contact name
  - `paused` true | false — Pause contact
  - `notification_targets` union, required
    - object[]
      - `severity` string — Contact target's severity level
      - `country_code` string — Country code
      - `number` string — Phone number
      - `provider` string — Provider
    - object[]
      - `severity` string — Contact target's severity level
      - `address` string — Email address

## Response `200`

Successful operation

- object
  - `contact` object
    - `id` string — ID of the created contact

---

[API](https://skmtc.net/pingdom/apis/pingdom-public-api.md) · [All operations](https://skmtc.net/pingdom/apis/pingdom-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pingdom/pingdom-public-api/revisions/d05c91a3c64b/schema)
