---
title: "Create User Contact"
method: POST
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/address-book/contact"
tags: ["External Contacts"]
---

# Create User Contact

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

## Request

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

Creates the user personal contact.

## Path parameters

- `accountId` string, required
- `extensionId` string, 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`

Created 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

## Other responses

- `400`: Contact cannot be created: max contacts count reached ($limit)

---

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