Last modified: Dec 20, 2024

Integrate an Altinn app with Correspondence

How to setup an integration between an Altinn App and Correspondence.

This guide details how to integrate the correspondence messaging service with an Altinn application. This integration enables an app to securely send digital messages and attachments to both organisations and individuals.

Prerequisites

  1. An applicable Altinn resource
  2. Altinn.App.Api and Altinn.App.Core v8.5.0 or greater

Altinn Resource

When sending a correspondence, it needs to be tied to an Altinn resource. This resource controls the access policy for the Correspondence, which is evaluated for both senders and receivers.

Please refer to the resource registration guide for more information on the setup process.

The resource needs to allow sender access for your organisation and recipient access for the appropriate role codes.

Note that for messages sent to a person, the code priv should be used. For messages sent to an organisation, whichever roles best describing your indented recipient should be used.

Implementation and usage

In order to use the correspondence service, the request must be authorised with an appropriate bearer token and a subscription key.

Please refer to the sections below for a detailed guide on how to achieve this: