> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# CreateSignerRequest

Request object for creating a new signer in a transaction. Defines the signer's identity,
authentication/verification requirements, notification preferences, and signing behavior.

**Key Requirements:**

- Email address is mandatory
- Either Authentications or Verifications must be provided (or both)
- Signers with AllowDelegation enabled cannot have Authentications
- SendSignRequest determines if sign request emails are sent automatically

#### Properties

| Name                     | Type                                                                                                                                                                                                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Id**                   | String                                                                                                                                                                                                               | <p>Signer identifier (can be provided or generated)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Expires**              | String                                                                                                                                                                                                               | <p>When the signer's access expires</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Email**                | String                                                                                                                                                                                                               | **Required**.  <p>Signer's email address</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Authentications**      | Array\<[SignerAuthentication](/openapi/models/SignerAuthentication.md)>                                                                                                                                              | <p>List of authentications that the signer has to authenticate with. The order in which the authentications are provided determine in which order the signer will have to perform the specified method.</p> <p>Authentications must be performed before the document(s) can be viewed.</p> <p>When the authentication SecureDownload is configured, the download url for a signer is authenticated with the same method as the signing url.</p> <p>The download url is returned in the response, and (optionally) emailed to the signer.</p> <p>You <strong>must</strong> explicitly specify the API-version when using this feature. This is done with the header: 'Accept: application/vnd.signhost.v1+json'.</p>                                                                                                                                                                                                                                                     |
| **Verifications**        | Array\<[SignerVerification](/openapi/models/SignerVerification.md)>                                                                                                                                                  | <p>List of verifications that the signer has to verify with.</p> <p>The order in which the verifications are provided determine in which order the signer will have to perform the specified method.</p> <p>Verifications must be performed before the document(s) can be signed.</p> <p><strong>Critical Requirement:</strong> You <strong>must</strong> use one of the following verification methods as the <strong>last</strong> verification in the list:</p> <ul> <li>Consent</li> <li>PhoneNumber</li> <li>Scribble</li> <li>CSC Qualified\*</li> </ul> <p><strong>Important Notes:</strong></p> <ul> <li>CSC Qualified <strong>must always be the final verification</strong> if used</li> <li>The other three methods (Consent, PhoneNumber, Scribble) can be succeeded by other verification methods</li> </ul> <p>Common mistake: Providing only authentication methods (e.g., iDIN) without including one of these required final verification methods.</p> |
| **SendSignRequest**      | Boolean                                                                                                                                                                                                              | <p>Whether to send sign request to this signer's email address</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **SendSignConfirmation** | Boolean                                                                                                                                                                                                              | <p>Whether to send a confirmation email to the signer after signing. Default value is the value of <code>SendSignRequest</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **SignRequestSubject**   | String                                                                                                                                                                                                               | <p>The subject of the sign request email in plain text. Maximum of 64 characters allowed.</p> <p>If omitted, the default subject will be used.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **SignRequestMessage**   | String                                                                                                                                                                                                               | <p>The message of the sign request email in plain text. HTML is not allowed. Newlines can be created by including a <code>\n</code>. Required if <code>SendSignRequest</code> is true.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **DaysToRemind**         | Integer                                                                                                                                                                                                              | <p>Number of days between automatic reminder emails sent to this signer.</p> <ul> <li>Set to <code>-1</code> to disable reminders entirely for this signer</li> <li>Set to <code>0</code> to use your organization's default reminder interval</li> <li>Set to a positive number (e.g., <code>3</code>, <code>7</code>) to send reminders every N days</li> </ul> <p><strong>Note:</strong> Reminders are only sent if <code>SendSignRequest</code> is <code>true</code> and the signer hasn't completed signing yet.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Language**             | enum: <ul> <li><code>de-DE</code></li> <li><code>en-US</code></li> <li><code>es-ES</code></li> <li><code>fr-FR</code></li> <li><code>it-IT</code></li> <li><code>pl-PL</code></li> <li><code>nl-NL</code></li> </ul> | <p>Language for signer interface and emails</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Reference**            | String                                                                                                                                                                                                               | <p>Custom reference for this signer</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **IntroText**            | String                                                                                                                                                                                                               | <p>Custom introduction text shown to the signer during the signing proces. This will be shown on the first screen to the signer and supports limited markdown markup. The following markup is supported:</p> <ul> <li><code># Headings</code></li> <li><code>\*Emphasis\*</code> / <code>\_Emphasis\_</code></li> <li><code>\*\*Strong\*\*</code> / <code>\_\_Strong\_\_</code></li> <li><code>1. Ordered</code> and <code>- Unordered</code> lists</li> </ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **ReturnUrl**            | String                                                                                                                                                                                                               | <p>URL to redirect signer after signing</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **AllowDelegation**      | Boolean                                                                                                                                                                                                              | <p>Whether this signer can delegate signing to another person. Cannot be used together with <code>Authentications</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Context**              | Object                                                                                                                                                                                                               | <p>Custom signer data (dynamic JSON object)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |