{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Prepare Your First Message","description":"Developer documentation for integrating systems that send messages, plus reporting and operational APIs for platform holders."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"prepare-your-first-message","__idx":0},"children":["Prepare Your First Message"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section explains how to prepare message content and envelope files before submitting a delivery to the Digital Postbox Platform."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Messages are prepared by creating one or more envelope files and preparing the referenced body and attachment files."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After preparation, files can be submitted using one of two methods:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["S3 Upload Method: upload envelopes and referenced files to an S3-compatible storage service before creating a delivery"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Direct Multipart Submission: submit envelopes and referenced files directly in a multipart request"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each envelope defines:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sender identity"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recipient identification"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Message content"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional message features"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Delivery metadata"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For S3 Upload Method, all envelopes and referenced files must be available in storage before creating a delivery."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To prepare a message for delivery, you must:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create one or more envelope files"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prepare message body and attachments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upload all files to storage"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify envelope references"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate recipient identification"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each envelope represents one logical message."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Multiple envelopes may be submitted in a single delivery."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"generate-envelope-files","__idx":2},"children":["Generate Envelope Files"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An envelope is a JSON document that describes a message."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It specifies:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Who sends the message"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Who receives the message"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which files are delivered"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which features apply"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Envelopes must conform to the platform envelope schema."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each envelope must have a unique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["messageId"]}," within the sender organisation."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"recipient-identification","__idx":3},"children":["Recipient Identification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recipients are identified using identity attributes provided by approved identity providers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each recipient must include an identity object with exactly one key-value pair, where the key is the identity type and the value is the recipient's identifier."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"identity\": {\n    \"NationalId\": \"1234567890\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supported identifiers may include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["National identifiers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Organization identifiers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User identifiers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Email address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mobile number"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Identity requirements depend on sender permissions."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"multiple-recipients","__idx":4},"children":["Multiple Recipients"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An envelope may contain up to ten recipients."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Delivery behavior is atomic:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All recipients receive the message"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Or no recipients receive the message"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If any recipient is invalid, unsubscribed, or unavailable, the envelope is rejected."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"scheduled-delivery","__idx":5},"children":["Scheduled Delivery"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Messages may be scheduled for future delivery."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliverAt"]}," field:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"deliverAt\": \"2026-03-01T08:00:00Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The value must follow RFC 3339 format."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If omitted, delivery occurs immediately."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"open-receipt","__idx":6},"children":["Open Receipt"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Senders may require recipients to accept that an open receipt will be sent before accessing the content."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"requireOpenReceipt\": true\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Restrictions:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only supported for single-recipient envelopes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["One receipt is registered per message"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Opening receipts can be retrieved from the administrative portal or via the APIs."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"interim-repository","__idx":7},"children":["Interim Repository"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a recipient does not have an account, messages are normally rejected."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The interim repository allows temporary storage per recipient."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"identity\": {\n    \"NationalId\": \"1234567890\"\n  },\n  \"interim\": {\n    \"enable\": true,\n    \"notificationEmail\": \"recipient@example.com\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Behavior:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Message is stored temporarily"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recipient is notified"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Delivery occurs after account creation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Undelivered messages are purged after the retention period."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"file-encryption","__idx":8},"children":["File Encryption"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Message files can be encrypted before upload. Encryption is optional but recommended when the sender requires additional control over confidentiality."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When encryption is used:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The same encryption key must be used for all files within the same delivery"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The encryption key must be recorded by the sender"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The encryption key must be provided when calling Create Delivery"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the provided key does not match the encrypted content, the delivery will fail during validation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supported encryption modes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AES 256 CBC"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AES 256 GCM, not yet supported and planned for near-term release"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"GCM not supported yet"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Support for AES 256 GCM mode is currently not available. Support is planned to be released in the near term. Until then, use AES 256 CBC."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AES 256 GCM will be the recommended mode once available, as it provides authenticated encryption and built-in integrity protection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using CBC mode:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["CBC does not include data integrity checks"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Corruption in encrypted data or an incorrect key will not be detected automatically"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It is important to include a content hash in the envelope so the platform can verify that the decrypted content matches the expected content"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For detailed encoding formats and reference implementations, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/delivery#encryption-during-delivery"},"children":["Encryption during delivery"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"file-size-limits","__idx":9},"children":["File Size Limits"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"s3-upload-method","__idx":10},"children":["S3 Upload Method"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Platform-enforced limits for deliveries using the S3 Upload Method:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Item"},"children":["Item"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"right","data-label":"Maximum"},"children":["Maximum"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File size"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["100 MB"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Envelope size"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["1 MB"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Messages per delivery"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["1000"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total request size"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["1 GB"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"direct-multipart-submission","__idx":11},"children":["Direct Multipart Submission"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Size limits for deliveries using Direct Multipart Submission:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Item"},"children":["Item"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"right","data-label":"Maximum"},"children":["Maximum"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total file size"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["8 MB"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Envelope size"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["1 MB"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total request size"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["9 MB"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Files exceeding limits are rejected during validation."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"content-hash-support","__idx":12},"children":["Content Hash Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Envelopes may optionally include a cryptographic hash string for referenced files."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If provided, the platform validates the file content against the supplied hash before processing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Hash verification is recommended when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Client-side encryption is used"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Files are transferred across multiple systems"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Data integrity must be verified"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Files may include an optional hash string for integrity validation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"body\": {\n    \"name\": \"refinancing-appointment-2020-01-07.rtf\",\n    \"mimeType\": \"text/rtf\",\n    \"filename\": \"refinancing-appointment.rtf\",\n    \"hash\": \"<HASH_VALUE_HERE>\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Hashes are recommended when using CBC encryption."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-1-create-an-invoice-envelope","__idx":13},"children":["Example 1: Create an Invoice Envelope"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example sends an invoice document to one recipient."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario","__idx":14},"children":["Scenario"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Invoice file:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"invoice-880942299.pdf\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sender:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"senderId: 3\norganizationId: 6\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recipient:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Identity value: Hugo\nIdentity type: Username\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"envelope-file","__idx":15},"children":["Envelope File"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save as:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"invoice-880942299.json\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"messageId\": \"invoice-880942299\",\n  \"title\": \"Invoice\",\n  \"sender\": {\n    \"senderId\": 3,\n    \"organizationId\": 6\n  },\n  \"recipients\": [\n    {\n      \"identity\": {\n        \"Username\": \"Hugo\"\n      }\n    }\n  ],\n  \"body\": {\n    \"name\": \"invoice-880942299.pdf\",\n    \"mimeType\": \"application/pdf\",\n    \"filename\": \"invoice.pdf\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Be aware that the envelope name must be the same as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["messageId"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".json"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-2-create-an-appointment-envelope","__idx":16},"children":["Example 2: Create an Appointment Envelope"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example sends an appointment confirmation with an attachment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-1","__idx":17},"children":["Scenario"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Message file:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"refinancing-appointment-2020-01-07.rtf\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Attachment file:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"refinancing-appointment-2020-01-07.pdf\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sender:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"senderId: 5\norganizationId: 8\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recipients:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Vigo\nAlma\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"envelope-file-1","__idx":18},"children":["Envelope File"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save as:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"refinancing-appointment-2020-01-07T11:45:00.000Z.json\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"messageId\": \"refinancing-appointment-2020-01-07T11:45:00.000Z\",\n  \"title\": \"Refinancing discussion\",\n  \"sender\": {\n    \"senderId\": 5,\n    \"organizationId\": 8\n  },\n  \"recipients\": [\n    {\n      \"identity\": {\n        \"Username\": \"Vigo\"\n      }\n    },\n    {\n      \"identity\": {\n        \"Username\": \"Alma\"\n      }\n    }\n  ],\n  \"body\": {\n    \"name\": \"refinancing-appointment-2020-01-07.rtf\",\n    \"title\": \"Refinancing\",\n    \"mimeType\": \"text/rtf\",\n    \"filename\": \"refinancing-appointment.rtf\"\n  },\n  \"attachments\": [\n    {\n      \"name\": \"refinancing-appointment-2020-01-07.pdf\",\n      \"title\": \"Refinancing appointment\",\n      \"mimeType\": \"application/pdf\",\n      \"filename\": \"refinancing-appointment.pdf\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"validation-checklist","__idx":19},"children":["Validation Checklist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before creating a delivery, verify:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All referenced files exist in storage"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All envelope filenames match uploaded objects"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["messageId"]}," values are unique"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recipient identities are valid"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional features are supported"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Encryption keys are available if used"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Validation failures are reported in delivery reports."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":20},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After preparing envelopes and content:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/getting-started/choosesubmissionmethod"},"children":["Choose a Submission Method"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/getting-started/upload-s3"},"children":["Upload Content to S3"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/getting-started/submit-multipart"},"children":["Send Messages via Multipart"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/getting-started/verify-delivery"},"children":["Verify and Troubleshoot"]}]}]}]},"headings":[{"value":"Prepare Your First Message","id":"prepare-your-first-message","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Generate Envelope Files","id":"generate-envelope-files","depth":2},{"value":"Recipient Identification","id":"recipient-identification","depth":2},{"value":"Multiple Recipients","id":"multiple-recipients","depth":2},{"value":"Scheduled Delivery","id":"scheduled-delivery","depth":2},{"value":"Open Receipt","id":"open-receipt","depth":2},{"value":"Interim Repository","id":"interim-repository","depth":2},{"value":"File Encryption","id":"file-encryption","depth":2},{"value":"File Size Limits","id":"file-size-limits","depth":2},{"value":"S3 Upload Method","id":"s3-upload-method","depth":3},{"value":"Direct Multipart Submission","id":"direct-multipart-submission","depth":3},{"value":"Content Hash Support","id":"content-hash-support","depth":2},{"value":"Example 1: Create an Invoice Envelope","id":"example-1-create-an-invoice-envelope","depth":2},{"value":"Scenario","id":"scenario","depth":3},{"value":"Envelope File","id":"envelope-file","depth":3},{"value":"Example 2: Create an Appointment Envelope","id":"example-2-create-an-appointment-envelope","depth":2},{"value":"Scenario","id":"scenario-1","depth":3},{"value":"Envelope File","id":"envelope-file-1","depth":3},{"value":"Validation Checklist","id":"validation-checklist","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Prepare Your First Message","description":"Create envelope files and prepare message content for delivery through the Digital Postbox Platform.","markdown":{"toc":{"depth":3}},"seo":{"title":"Prepare Your First Message"}},"lastModified":"2026-06-23T08:57:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/getting-started/prepare-message","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}