{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Overview","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":"overview","__idx":0},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section introduces the core concepts required to integrate with the Digital Post Platform."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It explains how the platform is structured, how messages are delivered, and how responsibilities and data flows are organized across organisations, sender identities, and receivers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before working with individual APIs, integrators should understand these fundamentals to ensure correct use of the platform and predictable integration behavior."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"purpose-of-this-documentation","__idx":1},"children":["Purpose of this documentation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This introduction section explains the platform concepts you need before integrating and is intended for developers and technical integrators."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It covers:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Digital Post Platform in context and roles"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The organisational model and ownership boundaries"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How messages are packaged, delivered, and tracked"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The message lifecycle from submission to delivery"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Core security concepts and controls"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The end to end integration flow"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is a conceptual overview and does not not describe administrative procedures, operational workflows, or user interface behavior."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-digital-post-platform-in-context","__idx":2},"children":["The Digital Post Platform in context"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Digital Post Platform is a secure infrastructure for large scale digital message delivery between senders and receivers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The platform is operated by e-Boks and made available to platform holders within defined market setups."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on the market, e-Boks or a partner organization acts as the platform holder, while e-Boks operates the underlying technical platform."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The platform enables:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submission of digital messages"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Management of sender identities"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Controlled delivery to receivers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Secure handling of message content"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Centralized reporting and auditing"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All message content is validated, scanned, encrypted, and processed before delivery."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"core-organisational-concepts","__idx":3},"children":["Core organisational concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All integrations operate within a structured organisational model."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The platform uses four core concepts consistently across APIs and workflows:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Platform holder"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Organisation account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sender identity"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Receiver"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These concepts define ownership, governance, and access boundaries."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Understanding how they relate to each other is required for correct use of sender management, message submission, mailbox access, and reporting APIs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Detailed explanations are provided in the section ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/platform-overview"},"children":["Organisational model"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"message-delivery-model","__idx":4},"children":["Message delivery model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Messages are delivered through structured deliveries that reference message envelopes and content stored in external storage."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each delivery contains one or more envelopes.",{"$$mdtype":"Tag","name":"br","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":["Recipients"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Message content"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Message features"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Delivery instructions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The platform guarantees that an envelope is delivered either to all recipients or to none."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Message validation, encryption, and distribution are handled by the platform."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The delivery model is explained in detail in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/introduction/delivery-model"},"children":["Message delivery model"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"message-lifecycle","__idx":5},"children":["Message lifecycle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each message follows a defined lifecycle from submission to final delivery."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ingestion and validation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recipient identification"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Subscription checks"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Security scanning"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Encryption"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Delivery"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Status reporting"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional receipt registration"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Understanding this lifecycle is important for handling errors, retries, and reporting."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The full lifecycle is described in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/introduction/message-lifecycle"},"children":["Message lifecycle"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Message lifecycle section does not contain any information about handling errors and retries. This is covered is covered in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/getting-started/verify-delivery"},"children":["Verify and Troubleshoot"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"security-concepts","__idx":6},"children":["Security concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The platform applies security controls at multiple levels, including:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Certificate based authentication"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Token based authorization"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Content encryption"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access control boundaries"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Audit logging"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This documentation describes security mechanisms at a conceptual level only."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Detailed operational security procedures are handled through separate administrative processes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An overview is available in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/introduction/security-concepts"},"children":["Security concepts"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"end-to-end-integration-flow","__idx":7},"children":["End to end integration flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most integrations follow the same high level flow:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Establish organisational and sender context"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure system integration and authentication"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prepare message content and envelopes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submit deliveries"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Monitor delivery status and logs"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve reports and usage data"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This flow is described further in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/getting-started/overview"},"children":["Getting Started Overview"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-use-this-section","__idx":8},"children":["How to use this section"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section is intended to be read before starting technical integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It provides the conceptual foundation required for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Getting Started guides"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API Reference documentation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Advanced integration scenarios"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After reviewing these pages, integrators should proceed to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/getting-started/overview"},"children":["Getting Started"]}," section to implement their first working integration."]}]},"headings":[{"value":"Overview","id":"overview","depth":1},{"value":"Purpose of this documentation","id":"purpose-of-this-documentation","depth":2},{"value":"The Digital Post Platform in context","id":"the-digital-post-platform-in-context","depth":2},{"value":"Core organisational concepts","id":"core-organisational-concepts","depth":2},{"value":"Message delivery model","id":"message-delivery-model","depth":2},{"value":"Message lifecycle","id":"message-lifecycle","depth":2},{"value":"Security concepts","id":"security-concepts","depth":2},{"value":"End to end integration flow","id":"end-to-end-integration-flow","depth":2},{"value":"How to use this section","id":"how-to-use-this-section","depth":2}],"frontmatter":{"seo":{"title":"Overview"}},"lastModified":"2026-02-18T13:48:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/introduction/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}