---
title: "PUT /v1/{+resourceName}"
method: PUT
path: "/v1/{+resourceName}"
tags: ["contactGroups"]
---

# PUT /v1/{+resourceName}

`PUT /v1/{+resourceName}`

Update the name of an existing contact group owned by the authenticated user. Updated contact group names must be unique to the users contact groups. Attempting to create a group with a duplicate name will return a HTTP 409 error. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.

## Path parameters

- `resourceName` string, required

## Request body

- UpdateContactGroupRequest — A request to update an existing user contact group. All updated fields will be replaced.
  - `updateGroupFields` string, google-fieldmask — Optional. A field mask to restrict which fields on the group are updated. Multiple fields can be specified by separating them with commas. Defaults to `name` if not set or set to empty. Updated fields are replaced. Valid values are: * clientData * name
  - `readGroupFields` string, google-fieldmask — Optional. A field mask to restrict which fields on the group are returned. Defaults to `metadata`, `groupType`, and `name` if not set or set to empty. Valid fields are: * clientData * groupType * memberCount * metadata * name
  - `contactGroup` ContactGroup — A contact group.
    - `etag` string — The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the resource. Used for web cache validation.
    - `metadata` ContactGroupMetadata — The metadata about a contact group.
      - `updateTime` string, google-datetime — Output only. The time the group was last updated.
      - `deleted` boolean — Output only. True if the contact group resource has been deleted. Populated only for [`ListContactGroups`](/people/api/rest/v1/contactgroups/list) requests that include a sync token.
    - `resourceName` string — The resource name for the contact group, assigned by the server. An ASCII string, in the form of `contactGroups/{contact_group_id}`.
    - `memberResourceNames` string[] — Output only. The list of contact person resource names that are members of the contact group. The field is only populated for GET requests and will only return as many members as `maxMembers` in the get request.
    - `formattedName` string — Output only. The name translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale for system groups names. Group names set by the owner are the same as name.
    - `clientData` GroupClientData[] — The group's client data.
      - `key` string — The client specified key of the client data.
      - `value` string — The client specified value of the client data.
    - `groupType` 'GROUP_TYPE_UNSPECIFIED' | 'USER_CONTACT_GROUP' | 'SYSTEM_CONTACT_GROUP' — Output only. The contact group type.
    - `memberCount` integer — Output only. The total number of contacts in the group irrespective of max members in specified in the request.
    - `name` string — The contact group name set by the group owner or a system provided name for system groups. For [`contactGroups.create`](/people/api/rest/v1/contactGroups/create) or [`contactGroups.update`](/people/api/rest/v1/contactGroups/update) the name must be unique to the users contact groups. Attempting to create a group with a duplicate name will return a HTTP 409 error.

## Response `200`

Successful response

---

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