---
title: "Update Contact Attributes"
method: PATCH
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/address-book/contact/{contactId}"
tags: ["External Contacts"]
---

# Update Contact Attributes

`PATCH /restapi/v1.0/account/{accountId}/extension/{extensionId}/address-book/contact/{contactId}`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/address-book/contact/{contactId}`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact/:contactId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Updates particular values of a personal contact attributes specified in request (partial resource update). Omitted attributes will remain unchanged.
If any attribute is passed in request body with the null value, then this attribute value will be removed.

## Path parameters

- `accountId` string, required
- `extensionId` string, required
- `contactId` integer, required

## Query parameters

- `dialingPlan` string

## Request body

- PersonalContactRequest
  - `firstName` string: First name of a contact
  - `lastName` string: Last name of a contact
  - `middleName` string: Middle name of a contact
  - `nickName` string: Nick name of a contact
  - `company` string: Company name of a contact
  - `jobTitle` string: Job title of a contact
  - `email` string, email: Email of a contact
  - `email2` string, email: Second email of a contact
  - `email3` string, email: Third email of a contact
  - `birthday` string, date-time: Date of birth of a contact
  - `webPage` string, uri: Contact home page URL
  - `notes` string: Notes for a contact
  - `homePhone` string: Home phone number of a contact in e.164 (with "+") format
  - `homePhone2` string: Second home phone number of a contact in e.164 (with "+") format
  - `businessPhone` string: Business phone of a contact in e.164 (with "+") format
  - `businessPhone2` string: Second business phone of a contact in e.164 (with "+") format
  - `mobilePhone` string: Mobile phone of a contact in e.164 (with "+") format
  - `businessFax` string: Business fax number of a contact in e.164 (with "+") format
  - `companyPhone` string: Company number of a contact in e.164 (with "+") format
  - `assistantPhone` string: Phone number of a contact assistant in e.164 (with "+") format
  - `carPhone` string: Car phone number of a contact in e.164 (with "+") format
  - `otherPhone` string: Other phone number of a contact in e.164 (with "+") format
  - `otherFax` string: Other fax number of a contact in e.164 (with "+") format
  - `callbackPhone` string: Callback phone number of a contact in e.164 (with "+") format
  - `homeAddress` ContactAddressInfo
    - `street` string: Street address
    - `city` string: City name
    - `country` string: Country name
    - `state` string: State/province name
    - `zip` string: Zip/Postal code
  - `businessAddress` ContactAddressInfo
    - `street` string: Street address
    - `city` string: City name
    - `country` string: Country name
    - `state` string: State/province name
    - `zip` string: Zip/Postal code
  - `otherAddress` ContactAddressInfo
    - `street` string: Street address
    - `city` string: City name
    - `country` string: Country name
    - `state` string: State/province name
    - `zip` string: Zip/Postal code
  - `ringtoneIndex` string: Contact ringtone. Max number of symbols is 64

## Response `200`

Edited personal contact information

- PersonalContactResource
  - `uri` string, uri: Canonical URI of a contact
  - `availability` 'Alive' | 'Deleted' | 'Purged': This property has a special meaning only on Address Book Sync (e.g. a contact can be `Deleted`). For simple contact list reading it has always the default value - `Alive`
  - `email` string, email: Email of a contact
  - `id` integer: Internal identifier of availability contact
  - `notes` string: Notes for a contact
  - `company` string: Company name of a contact
  - `firstName` string: First name of a contact
  - `lastName` string: Last name of a contact
  - `jobTitle` string: Job title of a contact
  - `birthday` string, date-time: Date of birth of a contact
  - `webPage` string, uri: The contact home page URL
  - `middleName` string: Middle name of a contact
  - `nickName` string: Nick name of a contact
  - `email2` string, email: Second email of a contact
  - `email3` string, email: Third email of a contact
  - `homePhone` string: Home phone number of a contact in e.164 (with "+") format
  - `homePhone2` string: Second home phone number of a contact in e.164 (with "+") format
  - `businessPhone` string: Business phone of the contact in e.164 (with "+") format
  - `businessPhone2` string: Second business phone of a contact in e.164 (with "+") format
  - `mobilePhone` string: Mobile phone of a contact in e.164 (with "+") format
  - `businessFax` string: Business fax number of a contact in e.164 (with "+") format
  - `companyPhone` string: Company number of a contact in e.164 (with "+") format
  - `assistantPhone` string: Phone number of a contact assistant in e.164 (with "+") format
  - `carPhone` string: Car phone number of a contact in e.164 (with "+") format
  - `otherPhone` string: Other phone number of a contact in e.164 (with "+") format
  - `otherFax` string: Other fax number of a contact in e.164 (with "+") format
  - `callbackPhone` string: Callback phone number of a contact in e.164 (with "+") format
  - `businessAddress` ContactAddressInfo
    - `street` string: Street address
    - `city` string: City name
    - `country` string: Country name
    - `state` string: State/province name
    - `zip` string: Zip/Postal code
  - `homeAddress` ContactAddressInfo
    - `street` string: Street address
    - `city` string: City name
    - `country` string: Country name
    - `state` string: State/province name
    - `zip` string: Zip/Postal code
  - `otherAddress` ContactAddressInfo
    - `street` string: Street address
    - `city` string: City name
    - `country` string: Country name
    - `state` string: State/province name
    - `zip` string: Zip/Postal code
  - `ringtoneIndex` string: Contact ringtone. Max number of symbols is 64

---

[API](https://skmtc.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)