---
title: "Update Favorite Contact List"
method: PUT
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/favorite"
tags: ["External Contacts"]
---

# Update Favorite Contact List

`PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/favorite`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/favorite`
- 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/favorite/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates the list of favorite contacts of the current extension.
Favorite contacts include both company contacts (extensions) and personal
contacts (address book records).**Please note**: Currently personal address
book size is limited to 10 000 contacts.

## Path parameters

- `accountId` string, required
- `extensionId` string, required

## Request body

- FavoriteCollection
  - `records` FavoriteContactResource[]
    - `id` integer
    - `extensionId` string
    - `accountId` string
    - `contactId` string

## Response `200`

Favorite contacts list

- FavoriteContactList
  - `uri` string, uri
  - `records` FavoriteContactResource[]
    - `id` integer
    - `extensionId` string
    - `accountId` string
    - `contactId` string

---

[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)