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

# CreateTransactionRequest

Transaction creation data including signers, receivers, files, and configuration.
This is the request body for creating a new transaction.

#### Properties

| Name                       | Type                                                                                                                                                                                                                 | Description                                                                                                                                                                                 |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Seal**                   | Boolean                                                                                                                                                                                                              | **Required**.  <p>Whether to seal the transaction (no signers required). When true, the transaction is automatically completed without requiring signatures.</p>                            |
| **Reference**              | String                                                                                                                                                                                                               | <p>Custom reference identifier for the transaction</p>                                                                                                                                      |
| **PostbackUrl**            | String                                                                                                                                                                                                               | <p>URL to receive status notifications about the transaction</p>                                                                                                                            |
| **DaysToExpire**           | Integer                                                                                                                                                                                                              | <p>Number of days until the transaction expires. If 0, uses organization default. Maximum value depends on organization settings.</p>                                                       |
| **SendEmailNotifications** | Boolean                                                                                                                                                                                                              | <p>Whether to send email notifications to signers and receivers</p>                                                                                                                         |
| **SignRequestMode**        | enum: <ul> <li><code>0</code></li> <li><code>1</code></li> <li><code>2</code></li> </ul>                                                                                                                             | <p>Mode for sign request delivery:</p> <ul> <li>0: No sign requests</li> <li>1: Send immediately</li> <li>2: Send when ready (default when signers have SendSignRequest enabled)</li> </ul> |
| **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 code for transaction interface and emails</p>                                                                                                                                   |
| **Context**                | Object                                                                                                                                                                                                               | <p>Custom JSON object for additional transaction data. Only JSON objects are allowed (no arrays or primitives).</p>                                                                         |
| **Signers**                | Array\<[CreateSignerRequest](/openapi/models/CreateSignerRequest.md)>                                                                                                                                                | <p>List of signers for the transaction</p>                                                                                                                                                  |
| **Receivers**              | Array\<[CreateReceiverRequest](/openapi/models/CreateReceiverRequest.md)>                                                                                                                                            | <p>List of receivers who get copies of completed documents</p>                                                                                                                              |

**Example:**

```json
{
  "Seal": false,
  "Reference": "CONTRACT-2024-001",
  "PostbackUrl": "https://example.com/webhook/signhost",
  "DaysToExpire": 30,
  "SendEmailNotifications": true,
  "SignRequestMode": 2,
  "Language": "en-US",
  "Context": {
    "department": "HR",
    "contract_type": "employment"
  },
  "Signers": [
    {
      "Email": "john.doe@example.com",
      "SendSignRequest": true,
      "SignRequestMessage": "Please review and sign the attached employment contract.",
      "Language": "en-US"
    }
  ],
  "Receivers": [
    {
      "Email": "hr@example.com",
      "Message": "The employment contract has been signed and is attached.",
      "Language": "en-US"
    }
  ]
}
```
