---
title: "PATCH /v1/{+name}"
method: PATCH
path: "/v1/{+name}"
tags: ["organizations"]
---

# PATCH /v1/{+name}

`PATCH /v1/{+name}`

Updates a contact. Note: A contact's email address cannot be changed.

## Path parameters

- `name` string, required

## Query parameters

- `updateMask` string

## Request body

- GoogleCloudEssentialcontactsV1Contact — A contact that will receive notifications from Google Cloud.
  - `name` string — Output only. The identifier for the contact. Format: {resource_type}/{resource_id}/contacts/{contact_id}
  - `email` string — Required. The email address to send notifications to. The email address does not need to be a Google Account.
  - `notificationCategorySubscriptions` string[] — Required. The categories of notifications that the contact will receive communications for.
  - `languageTag` string — Required. The preferred language for notifications, as a ISO 639-1 language code. See [Supported languages](https://cloud.google.com/resource-manager/docs/managing-notification-contacts#supported-languages) for a list of supported languages.
  - `validationState` 'VALIDATION_STATE_UNSPECIFIED' | 'VALID' | 'INVALID' — Output only. The validity of the contact. A contact is considered valid if it is the correct recipient for notifications for a particular resource.
  - `validateTime` string, google-datetime — Output only. The last time the validation_state was updated, either manually or automatically. A contact is considered stale if its validation state was updated more than 1 year ago.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/essentialcontacts.md) · [All operations](https://skmtc.net/google/apis/essentialcontacts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/essentialcontacts/versions/fbaa8091a93a/schema)