> 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 # UserSignatures Resource The UserSignatures resource provides methods that allow you manage the initials and signature images for a user. ## Methods supported | Method | Description | | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [create](/docs/esign-rest-api/reference/users/usersignatures/create) | POST `/restapi/v2.1/accounts/{accountId}/users/{userId}/signatures` Adds user Signature and initials images to a Signature. | | [delete](/docs/esign-rest-api/reference/users/usersignatures/delete) | DEL `/restapi/v2.1/accounts/{accountId}/users/{userId}/signatures/{signatureId}` Removes removes signature information for the specified user. | | [deleteImage](/docs/esign-rest-api/reference/users/usersignatures/deleteimage) | DEL `/restapi/v2.1/accounts/{accountId}/users/{userId}/signatures/{signatureId}/{imageType}` Deletes the user initials image or the user signature image for the specified user. | | [get](/docs/esign-rest-api/reference/users/usersignatures/get) | GET `/restapi/v2.1/accounts/{accountId}/users/{userId}/signatures/{signatureId}` Gets the user signature information for the specified user. | | [getImage](/docs/esign-rest-api/reference/users/usersignatures/getimage) | GET `/restapi/v2.1/accounts/{accountId}/users/{userId}/signatures/{signatureId}/{imageType}` Retrieves the user initials image or the user signature image for the specified user. | | [list](/docs/esign-rest-api/reference/users/usersignatures/list) | GET `/restapi/v2.1/accounts/{accountId}/users/{userId}/signatures` Retrieves a list of signature definitions for a user. | | [update](/docs/esign-rest-api/reference/users/usersignatures/update) | PUT `/restapi/v2.1/accounts/{accountId}/users/{userId}/signatures/{signatureId}` Updates the user signature for a specified user. | | [updateImage](/docs/esign-rest-api/reference/users/usersignatures/updateimage) | PUT `/restapi/v2.1/accounts/{accountId}/users/{userId}/signatures/{signatureId}/{imageType}` Updates the user signature image or user initials image for the specified user. | | [updateList](/docs/esign-rest-api/reference/users/usersignatures/updatelist) | PUT `/restapi/v2.1/accounts/{accountId}/users/{userId}/signatures` Adds/updates a user signature. | ## UserSignatures properties | Property | Type | Description | | ------------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `adoptedDateTime` | string | The date and time the user adopted their signature. | | `createdDateTime` | string | The UTC date and time when the user created the signature. | | `customField` | string | Serialized information about any custom [eHanko stamps](https://support.docusign.com/s/articles/Sending-and-Signing-with-eHanko) that have been ordered from an eHanko provider, including the order status, purchase order id, time created, and time modified. | | `dateStampProperties` | dateStampProperties | Specifies the area in which a date stamp is placed. This parameter uses pixel positioning to draw a rectangle at the center of the stamp area. The stamp is superimposed on top of this central area. This property contains the following information about the central rectangle:- `DateAreaX`: The X axis position of the top-left corner. - `DateAreaY`: The Y axis position of the top-left corner. - `DateAreaWidth`: The width of the rectangle. - `DateAreaHeight`: The height of the rectangle. | | `disallowUserResizeStamp` | string | When **true,** users may not resize the stamp. | | `errorDetails` | errorDetails | This object describes errors that occur. It is only valid for responses and ignored in requests. | | `externalID` | string | An external ID for the signature or stamp. **Note:** If a recipient uses a stamp instead of a signature, this is the stamp vendor's serial number for the stamp. | | `imageBase64` | string | A Base64-encoded representation of the signature image. | | `imageType` | string | The format of the signature image, such as:- `GIF` - `PNG` - `JPG` - `PDF` - `BMP` | | `initials150ImageId` | string | The ID of the user's initials image. | | `initialsImageUri` | string | The URI for retrieving the image of the user's initials. | | `isDefault` | string | Boolean that specifies whether the signature is the default signature for the user. | | `lastModifiedDateTime` | string | The UTC date and time when the signature was last modified. | | `nrdsId` | string | The National Association of Realtors (NAR) membership ID for a user who is a realtor. | | `nrdsLastName` | string | The realtor's last name. | | `nrdsStatus` | string | The realtor's NAR membership status. The value `active` verifies that the user is a current NAR member. Valid values are:- `Active` - `Inactive` - `Terminate` - `Provisional` - `Deceased` - `Suspend` - `Unknown` | | `phoneticName` | string | The phonetic spelling of the `signatureName`. | | `signature150ImageId` | string | The ID of the user's signature image. | | `signatureFont` | string | The font type for the signature, if the signature is not drawn. The supported font types are: "7_DocuSign", "1_DocuSign", "6_DocuSign", "8_DocuSign", "3_DocuSign", "Mistral", "4_DocuSign", "2_DocuSign", "5_DocuSign", "Rage Italic" | | `signatureId` | string | The ID associated with the signature name. You can use this property in the URI in place of the signature name. This enables the use of special characters (such as "&", "\<", and ">") in a signature name. **Note:** When you update a signature, its signature ID might change. In that case you need to use `signatureName` to get the new `signatureId`. | | `signatureImageUri` | string | An endpoint URI that you can use to retrieve the user's signature image. | | `signatureInitials` | string | The initials associated with the signature. | | `signatureName` | string | Specifies the user's signature name. | | `signatureRights` | string | The rights that the user has to the signature. Valid values are:- `none` - `read` - `admin` | | `signatureType` | string | Specifies the type of signature. Possible values include:- `RubberStamp`: A Docusign pre-formatted signature style. This is the default value. - `Imported`: A signature image that the user uploaded. - `Drawn`: A freehand drawing of the user's signature and initials. | | `stampFormat` | string | The format of a stamp. Valid values are:- `NameHanko`: The stamp represents only the signer's name. - `NameDateHanko`: The stamp represents the signer's name and the date. | | `stampImageUri` | string | The URI for retrieving the image of the user's stamp. | | `stampSizeMM` | string | The physical height of the stamp image (in millimeters) that the stamp vendor recommends for displaying the image in PDF documents. | | `stampType` | string | The type of stamp. Valid values are:- `signature`: A signature image. This is the default value. - `stamp`: A stamp image. - null | | `status` | string | Indicates the envelope status. Valid values are:- sent - The envelope is sent to the recipients. - created - The envelope is saved as a draft and can be modified and sent later. | ## API Docs - UserSignatures [Add user signatures](https://developers.docusign.com/docs/esign-rest-api/reference/users/usersignatures/create.md) - UserSignatures [Remove removes signature information](https://developers.docusign.com/docs/esign-rest-api/reference/users/usersignatures/delete.md) - UserSignatures [Delete user initials image or user signature image](https://developers.docusign.com/docs/esign-rest-api/reference/users/usersignatures/deleteimage.md) - UserSignatures [Get user signature information](https://developers.docusign.com/docs/esign-rest-api/reference/users/usersignatures/get.md) - UserSignatures [Get user initials image or user signature image](https://developers.docusign.com/docs/esign-rest-api/reference/users/usersignatures/getimage.md) - UserSignatures [List signature definitions](https://developers.docusign.com/docs/esign-rest-api/reference/users/usersignatures/list.md) - UserSignatures [Update user signature](https://developers.docusign.com/docs/esign-rest-api/reference/users/usersignatures/update.md) - UserSignatures [Update user signature image or user initials image](https://developers.docusign.com/docs/esign-rest-api/reference/users/usersignatures/updateimage.md) - UserSignatures [Add or update user signature](https://developers.docusign.com/docs/esign-rest-api/reference/users/usersignatures/updatelist.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)