---
title: "Upload Multiple User Contacts"
method: POST
path: "/restapi/v1.0/account/{accountId}/address-book-bulk-upload"
tags: ["External Contacts"]
---

# Upload Multiple User Contacts

`POST /restapi/v1.0/account/{accountId}/address-book-bulk-upload`

Uploads multiple contacts for multiple extensions at once.
Maximum 500 extensions can be uploaded per request. Max amount
of contacts that can be uploaded per extension is 10,000.
Each contact uploaded for a certain extension is not visible
to other extensions.

## Path parameters

- `accountId` string, required

## Request body

- AddressBookBulkUploadRequest
  - `records` AddressBookBulkUploadResource[], required
    - `extensionId` string, required
    - `contacts` AddressBookBulkContactResource[], required
      - `email` string, email — Email of a 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 — Link to a contact home page
      - `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 the 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 the 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` AddressBookBulkContactAddressInfo
        - `country` string — Country name of the extension user company. Not returned for Address Book
        - `state` string — State/province name of the extension user company
        - `city` string — City name of the extension user company
        - `street` string — Street address of the extension user company
        - `zip` string — Zip code of the extension user company
      - `homeAddress` AddressBookBulkContactAddressInfo
        - `country` string — Country name of the extension user company. Not returned for Address Book
        - `state` string — State/province name of the extension user company
        - `city` string — City name of the extension user company
        - `street` string — Street address of the extension user company
        - `zip` string — Zip code of the extension user company
      - `otherAddress` AddressBookBulkContactAddressInfo
        - `country` string — Country name of the extension user company. Not returned for Address Book
        - `state` string — State/province name of the extension user company
        - `city` string — City name of the extension user company
        - `street` string — Street address of the extension user company
        - `zip` string — Zip code of the extension user company

## Response `202`

Accepted

- AddressBookBulkUploadResponse — Information on a task for adding multiple contacts to multiple extensions
  - `id` string, required — Internal identifier of a task
  - `uri` string, uri, required — Link for the task status retrieval
  - `status` 'Accepted' | 'InProgress' | 'Completed' | 'Failed', required — Task status
  - `creationTime` string, date-time, required — Date/time of a task creation
  - `lastModifiedTime` string, date-time, required — Date/time of a task latest update
  - `results` AddressBookBulkUploadTaskResult
    - `affectedItems` AddressBookBulkUploadResource[]
      - `extensionId` string, required
      - `contacts` AddressBookBulkContactResource[], required
        - `email` string, email — Email of a 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 — Link to a contact home page
        - `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 the 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 the 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` AddressBookBulkContactAddressInfo
          - `country` string — Country name of the extension user company. Not returned for Address Book
          - `state` string — State/province name of the extension user company
          - `city` string — City name of the extension user company
          - `street` string — Street address of the extension user company
          - `zip` string — Zip code of the extension user company
        - `homeAddress` AddressBookBulkContactAddressInfo
          - `country` string — Country name of the extension user company. Not returned for Address Book
          - `state` string — State/province name of the extension user company
          - `city` string — City name of the extension user company
          - `street` string — Street address of the extension user company
          - `zip` string — Zip code of the extension user company
        - `otherAddress` AddressBookBulkContactAddressInfo
          - `country` string — Country name of the extension user company. Not returned for Address Book
          - `state` string — State/province name of the extension user company
          - `city` string — City name of the extension user company
          - `street` string — Street address of the extension user company
          - `zip` string — Zip code of the extension user company
    - `errors` ErrorEntity[]
      - `errorCode` string — Error code
      - `message` string — Error message
      - `parameterName` string — Name of invalid parameter
      - `parameterValue` string — Value of invalid parameter

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)