> 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/v2/reference/users/usersignatures/create) | POST `/restapi/v2/accounts/{accountId}/users/{userId}/signatures` Adds user Signature and initials images to a Signature. | | [delete](/docs/esign-rest-api/v2/reference/users/usersignatures/delete) | DEL `/restapi/v2/accounts/{accountId}/users/{userId}/signatures/{signatureId}` Removes removes signature information for the specified user. | | [deleteImage](/docs/esign-rest-api/v2/reference/users/usersignatures/deleteimage) | DEL `/restapi/v2/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/v2/reference/users/usersignatures/get) | GET `/restapi/v2/accounts/{accountId}/users/{userId}/signatures/{signatureId}` Gets the user signature information for the specified user. | | [getImage](/docs/esign-rest-api/v2/reference/users/usersignatures/getimage) | GET `/restapi/v2/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/v2/reference/users/usersignatures/list) | GET `/restapi/v2/accounts/{accountId}/users/{userId}/signatures` Retrieves a list of user signature definitions for a specified user. | | [update](/docs/esign-rest-api/v2/reference/users/usersignatures/update) | PUT `/restapi/v2/accounts/{accountId}/users/{userId}/signatures/{signatureId}` Updates the user signature for a specified user. | | [updateImage](/docs/esign-rest-api/v2/reference/users/usersignatures/updateimage) | PUT `/restapi/v2/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/v2/reference/users/usersignatures/updatelist) | PUT `/restapi/v2/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 | Indicates the date and time the item was created. | | `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. | | `errorDetails` | errorDetails | Array or errors. | | `externalID` | string | | | `imageType` | string | | | `initials150ImageId` | string | | | `initialsImageUri` | string | Contains the URI for an endpoint that you can use to retrieve the initials image. | | `isDefault` | string | | | `phoneticName` | string | | | `signature150ImageId` | string | | | `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 | Specifies the signature ID associated with the signature name. You can use the signature ID in the URI in place of the signature name, and the value stored in the `signatureName` property in the body is used. This allows the use of special characters (such as "&", "\<", ">") in a the signature name. Note that with each update to signatures, the returned signature ID might change, so the caller will need to trigger off the signature name to get the new signature ID. | | `signatureImageUri` | string | Contains the URI for an endpoint that you can use to retrieve the signature image. | | `signatureInitials` | string | The initials associated with the signature. | | `signatureName` | string | Specifies the user signature name. | | `signatureType` | string | | | `stampFormat` | string | | | `stampImageUri` | string | | | `stampSizeMM` | string | | | `stampType` | string | | ## API Docs - UserSignatures [Add user signatures](https://developers.docusign.com/docs/esign-rest-api/v2/reference/users/usersignatures/create.md) - UserSignatures [Remove removes signature information](https://developers.docusign.com/docs/esign-rest-api/v2/reference/users/usersignatures/delete.md) - UserSignatures [Delete user initials image or user signature image](https://developers.docusign.com/docs/esign-rest-api/v2/reference/users/usersignatures/deleteimage.md) - UserSignatures [Get user signature information](https://developers.docusign.com/docs/esign-rest-api/v2/reference/users/usersignatures/get.md) - UserSignatures [Get user initials image or user signature image](https://developers.docusign.com/docs/esign-rest-api/v2/reference/users/usersignatures/getimage.md) - UserSignatures [List signature definitions](https://developers.docusign.com/docs/esign-rest-api/v2/reference/users/usersignatures/list.md) - UserSignatures [Update user signature](https://developers.docusign.com/docs/esign-rest-api/v2/reference/users/usersignatures/update.md) - UserSignatures [Update user signature image or user initials image](https://developers.docusign.com/docs/esign-rest-api/v2/reference/users/usersignatures/updateimage.md) - UserSignatures [Add or update user signature](https://developers.docusign.com/docs/esign-rest-api/v2/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)