> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL. > > Documentation indexes by section: > - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt > - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt > - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt > - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt > > Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth > Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks > > OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json > MCP server: https://docusign.docs.buildwithfern.com/_mcp/server # Contacts Resource Docusign eSignature includes a contacts list (also referred to as an address book) to help make sending envelopes even easier. When you send an envelope, the recipients' names and email addresses are automatically added to your contacts list. You can use the contacts list to quickly add recipients to the envelopes you send. The `Contacts` resource provides methods that enable you to manage your contacts. ## Methods supported | Method | Description | | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | [create](/docs/esign-rest-api/reference/users/contacts/create) | POST `/restapi/v2.1/accounts/{accountId}/contacts` Add contacts to a contacts list. | | [delete](/docs/esign-rest-api/reference/users/contacts/delete) | DEL `/restapi/v2.1/accounts/{accountId}/contacts/{contactId}` Deletes a contact. | | [deleteList](/docs/esign-rest-api/reference/users/contacts/deletelist) | DEL `/restapi/v2.1/accounts/{accountId}/contacts` Deletes multiple contacts from an account. | | [get](/docs/esign-rest-api/reference/users/contacts/get) | GET `/restapi/v2.1/accounts/{accountId}/contacts/{contactId}` Gets one or more contacts. | | [update](/docs/esign-rest-api/reference/users/contacts/update) | PUT `/restapi/v2.1/accounts/{accountId}/contacts` Updates one or more contacts. | ## Contacts properties | Property | Type | Description | | -------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `canManage` | string | | | `cloudProvider` | string | The cloud service that provided the contact. Valid values are:- `rooms` - `docusignCore` (default) | | `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` | array | 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 authenticationYou must ask the user who added the contact for the phone number and then manually enter it into the authentication box. | | `contactUri` | string | The URI for retrieving information about the contact. | | `emails` | array | The email address or addresses associated with the contact. | | `errorDetails` | errorDetails | This object describes errors that occur. It is only valid for responses and ignored in requests. | | `isOwner` | boolean | When **true,** the current user is the owner of the contact. | | `name` | string | The name of the contact. | | `notaryContactDetails` | notaryContactDetails | | | `organization` | string | The name of the contact's organization. | | `roomContactType` | string | | | `shared` | string | When **true,** the contact is shared. For more information, see [Shared Contacts](https://support.docusign.com/s/document-item?bundleId=jux1643235969954\&topicId=twh1578456324503.html). **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 authenticationYou must ask the user who added the contact for the phone number and then manually enter it into the authentication box. | | `signingGroup` | string | If the contact belongs to a signing group, this property contains the `signingGroupId`. | | `signingGroupName` | string | The name of the signing group that the contact belongs to. | ## API Docs - Contacts [Add contacts to contacts list](https://developers.docusign.com/docs/esign-rest-api/reference/users/contacts/create.md) - Contacts [Delete contact](https://developers.docusign.com/docs/esign-rest-api/reference/users/contacts/delete.md) - Contacts [Delete multiple contacts](https://developers.docusign.com/docs/esign-rest-api/reference/users/contacts/deletelist.md) - Contacts [Get contacts](https://developers.docusign.com/docs/esign-rest-api/reference/users/contacts/get.md) - Contacts [Update contacts](https://developers.docusign.com/docs/esign-rest-api/reference/users/contacts/update.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://developers.docusign.com/openapi.json) - [OpenAPI YAML](https://developers.docusign.com/openapi.yaml)