---
title: "Deletes multiple contacts from an account."
method: DELETE
path: "/v2.1/accounts/{accountId}/contacts"
tags: ["Contacts"]
---

# Deletes multiple contacts from an account.

`DELETE /v2.1/accounts/{accountId}/contacts`

This method deletes multiple contacts associated with an account.

## Path parameters

- `accountId` string, required

## Request body

- ContactModRequest — The request object containing the new information for the contacts.
  - `contactList` Contact[] — A list of contacts.
    - `canManage` string
    - `cloudProvider` string — The cloud service that provided the contact. Valid values are: - `rooms` - `docusignCore` (default) <!-- Future: - `Box` - `GoogleDrive` - `Dropbox` - `SalesForce` - `SkyDrive` -->
    - `cloudProviderContainerId` string — The ID of the container at the cloud provider. For example, this might be the room ID for a Docusign Transaction Room.
    - `contactId` string — The ID of a contact person in the account's address book.
    - `contactPhoneNumbers` ContactPhoneNumber[] — A list of the contact's phone numbers. **Note:** The phone numbers associated with shared contacts do not display to users other than the user who added the contact. Additionally, in the following scenarios, the phone number of a shared contact does not populate automatically for anyone other than the user who added the contact: - Sending an envelope by using SMS - Using phone authentication You must ask the user who added the contact for the phone number and then manually enter it into the authentication box.
      - `phoneNumber` string — The contact's phone number. Example: `+12223334444`
      - `phoneType` string — The type of phone number. Valid values are: - `home` - `mobile` - `work` - `other` - `fax`
    - `contactUri` string — The URI for retrieving information about the contact.
    - `emails` string[] — An array of email addresses.
    - `errorDetails` ErrorDetails — This object describes errors that occur. It is only valid for responses and ignored in requests.
      - `errorCode` string — The code associated with the error condition.
      - `message` string — A brief message describing the error condition.
    - `isOwner` boolean
    - `name` string — The name of the contact.
    - `notaryContactDetails` NotaryContactDetails
      - `hasDocusignCertificate` string
      - `jurisdictions` JurisdictionSummary[]
        - `authorizedForIPen` string
        - `authorizedForRon` string
        - `jurisdictionId` string — The ID of the jurisdiction. The following jurisdictions are supported: - `5 - California` - `6 - Colorado` - `9 - Florida` - `10 - Georgia` - `12 - Idaho` - `13 - Illinois` - `14 - Indiana` - `15 - Iowa` - `17 - Kentucky` - `23 - Minnesota` - `25 - Missouri` - `30 - New Jersey` - `32 - New York` - `33 - North Carolina` - `35 - Ohio` - `37 - Oregon` - `38 - Pennsylvania` - `40 - South Carolina` - `43 - Texas` - `44 - Utah` - `47 - Washington` - `48 - West Virginia` - `49 - Wisconsin` - `62 - Florida Commissioner of Deeds`
        - `jurisdictionName` string
    - `organization` string
    - `roomContactType` string
    - `shared` string — When **true,** this contact is shared.
    - `signingGroup` string — The ID of the signing group.
    - `signingGroupName` string — Optional. The name of the signing group. Maximum Length: 100 characters.

## Response `200`

Successful response.

## Other responses

- `400` — Error encountered.

---

[API](https://skmtc.net/docusign/apis/docusign-esignature-rest-api.md) · [All operations](https://skmtc.net/docusign/apis/docusign-esignature-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/docusign/docusign-esignature-rest-api/versions/77f1998c313d/schema)