---
title: "Update a contact"
method: PUT
path: "/alerting/contacts/{contactid}"
tags: ["Contacts"]
---

# Update a contact

`PUT /alerting/contacts/{contactid}`

Update a contact with at least one contact method (notification target)

## Path parameters

- `contactid` integer, required

## Request body

- UpdateContact
  - `name` string, required — Contact name
  - `paused` true | false, required — 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

- Contact
  - `contact` ContactTargets
    - `id` integer — Contact ID
    - `name` string — Contact name
    - `paused` true | false — Describes whether alerts are paused for this contact
    - `type` 'user' | 'contact' — Type defines whether this is a user (login user) or a contact only
    - `owner` true | false — Indicates whether the contact is the owner of the organization
    - `notification_targets` union
      - 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
      - object[]
        - `severity` string — Contact target's severity level
        - `device_name` string — Contact targets's device name
        - `apns_device` string — Contact target's apns
      - object[]
        - `severity` string — Contact target's severity level
        - `agcm_id` string — Contact target's agcm id
    - `teams` object[]
      - `id` integer — Team ID
      - `name` string — Name of the team

---

[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/versions/d05c91a3c64b/schema)