Skip to navigation

Contacts Resource

View as Markdown

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

MethodDescription
createPOST /restapi/v2.1/accounts/{accountId}/contacts
Add contacts to a contacts list.
deleteDEL /restapi/v2.1/accounts/{accountId}/contacts/{contactId}
Deletes a contact.
deleteListDEL /restapi/v2.1/accounts/{accountId}/contacts
Deletes multiple contacts from an account.
getGET /restapi/v2.1/accounts/{accountId}/contacts/{contactId}
Gets one or more contacts.
updatePUT /restapi/v2.1/accounts/{accountId}/contacts
Updates one or more contacts.

Contacts properties

PropertyTypeDescription
canManagestring
cloudProviderstringThe cloud service that provided the contact. Valid values are:
  • rooms
  • docusignCore (default)
cloudProviderContainerIdstringThe ID of the container at the cloud provider. For example, this might be the room ID for a Docusign Transaction Room.
contactIdstringThe ID of a contact person in the account’s address book.
contactPhoneNumbersarrayA 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.
contactUristringThe URI for retrieving information about the contact.
emailsarrayThe email address or addresses associated with the contact.
errorDetailserrorDetailsThis object describes errors that occur. It is only valid for responses and ignored in requests.
isOwnerbooleanWhen true, the current user is the owner of the contact.
namestringThe name of the contact.
notaryContactDetailsnotaryContactDetails
organizationstringThe name of the contact’s organization.
roomContactTypestring
sharedstringWhen true, the contact is shared. For more information, see Shared Contacts.

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.
signingGroupstringIf the contact belongs to a signing group, this property contains the signingGroupId.
signingGroupNamestringThe name of the signing group that the contact belongs to.