Delete multiple contacts

DELETE

/v2.1/accounts/:accountId/contacts

DELETE

/restapi/v2.1/accounts/:accountId/contacts

curl -X DELETE https://demo.docusign.net/restapi/v2.1/accounts/ACCOUNT_ID/contacts \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "contactList": [
    {
      "canManage": "sample string 1",
      "cloudProvider": "sample string 2",
      "cloudProviderContainerId": "sample string 3",
      "contactId": "sample string 4",
      "contactPhoneNumbers": [
        {
          "phoneNumber": "sample string 1",
          "phoneType": "sample string 2"
        }
      ],
      "contactUri": "sample string 5",
      "emails": [
        "sample string 1"
      ],
      "errorDetails": {
        "errorCode": "sample string 1",
        "message": "sample string 2"
      },
      "isOwner": true,
      "name": "sample string 6",
      "notaryContactDetails": {
        "hasDocusignCertificate": "sample string 1",
        "jurisdictions": [
          {
            "authorizedForIPen": "sample string 1",
            "authorizedForRon": "sample string 2",
            "jurisdictionId": "sample string 3",
            "jurisdictionName": "sample string 4"
          }
        ]
      },
      "organization": "sample string 7",
      "roomContactType": "sample string 8",
      "shared": "sample string 9",
      "signingGroup": "sample string 10",
      "signingGroupName": "sample string 11"
    }
  ]
}'

{
  "contacts": [
    {
      "canManage": "sample string 1",
      "cloudProvider": "sample string 2",
      "cloudProviderContainerId": "sample string 3",
      "contactId": "sample string 4",
      "contactPhoneNumbers": [
        {
          "phoneNumber": "sample string 1",
          "phoneType": "sample string 2"
        }
      ],
      "contactUri": "sample string 5",
      "emails": [
        "sample string 1"
      ],
      "errorDetails": {
        "errorCode": "sample string 1",
        "message": "sample string 2"
      },
      "isOwner": true,
      "name": "sample string 6",
      "notaryContactDetails": {
        "hasDocusignCertificate": "sample string 1",
        "jurisdictions": [
          {
            "authorizedForIPen": "sample string 1",
            "authorizedForRon": "sample string 2",
            "jurisdictionId": "sample string 3",
            "jurisdictionName": "sample string 4"
          }
        ]
      },
      "organization": "sample string 7",
      "roomContactType": "sample string 8",
      "shared": "sample string 9",
      "signingGroup": "sample string 10",
      "signingGroupName": "sample string 11"
    }
  ]
}

This method deletes multiple contacts associated with an account. Note: A maximum of 3,000 contacts can be deleted with a single call to this endpoint.

Users can delete their own contacts, and account administrators can delete Shared contacts within the same account.

Authentication

AuthorizationBearer

OAuth 2.0 access token (JWT or auth-code grant). Sent as Authorization: Bearer <token> on every request except GET /v2.1 and GET /service_information, which are public discovery endpoints.

Path parameters

accountIdstringRequired

The external account number (int) or account ID Guid.

Request

This endpoint expects an object: contactModRequest

contactListlist of objectsOptional

A list of contacts.

Response

Successful response.

contactslist of objectsOptional

A list of contacts.

Errors

400

Bad Request Error