Notify the Digital and Population Data Services Agency that you want to display Suomi.fi Messages inboxes in your digital mail service.
Becoming a Suomi.fi Messages digital mail operator
What is a digital mail operator?
A digital mail operator provides their digital mail service or viewing application to end users for reading notifications and other messages from authorities in Suomi.fi Messages.
A digital mail operator:
- provides a service directly to the end user,
- uses strong identification to verify the user,
- asks the user for permission to display official messages in its service,
- displays the user’s Suomi.fi Messages inbox through the Digital and Population Data Services Agency’s APIs, and
- provides its own user communications, guidance and support.
Please note: these instructions are for digital mail service operators. If your organisation sends messages, is a system supplier or technical integration partner for another organisation, you are not a digital mail operator.
A digital mail operator is strictly an organisation that provides a service to end users under an agreement with the Digital and Population Data Services Agency.
1. Indicate your interest
Contact the Digital and Population Data Services Agency at viestit-kayttoonotot@dvv.fi and indicate your interest to displaying official messages sent in Suomi.fi Messages in your digital mail service.
After you contact us, we will tell you about:
- connection process,
- requirements,
- agreements,
- testing, and
- the deployment process.
2. Review the requirements and see if your service meets them
Make sure that your service meets all the requirements for digital mail operators and digital mail services.
Review the material:
- Interface descriptions (api.messages.suomi.fi)Opens in a new window.
- Terms of use and contract documents (available later on this page)
In particular, consider the following:
User functionality
- strong user identification
- secure display of official messages
- user access management
- provision of sufficient information to the user on the service.
Data security and privacy
- processing of personal data
- logging and traceability
- data security management policies
- preparing for incidents.
Communications, user support and customer service
- user advice
- customer guidance in various situations
- handling of questions on official messages
- communication of incidents to users.
3. Sign the agreement with the DVV
Digital mail operators must conclude the agreement with the DVV before production use.
The agreement consists of the following documents (to be published later here):
Document | Description |
|---|---|
Digital mail operator agreement (main agreement) | Definition of the responsibilities, rights, and duties of the parties. |
Appendix: Security appendix | Description of the security arrangements, confidentiality, data protection and other information security matters, covering the life cycle of the digital mail service, the activities of the digital mail operator and the continuity of service production during various disruptions. |
Appendix: Cooperation appendix | Description of the cooperation required of DVV-approved partners that provide a digital mail service. |
Appendix: Requirement matrix | Description of the technical, functional and security-related requirements that the digital mail service must meet. |
Appendix: Testing, review and approval process | Description of the testing, review and approval processes that are used before the service is approved for production use and to changes during the agreement period. |
Appendix: Service description | Description of the service provider’s approved digital mail service that connects to Suomi.fi Messages, which serves as a user interface for the messaging service for electronic notifications and other communications. |
4. Implement and test the integration
When the agreement process is underway, you can begin to implement the integration.
Interfaces
DVV provides APIs for:
- user access management
- listing messages
- relaying information about displaying messages
- relaying read receipts and acknowledgements.
Interface documentation (api.messages.suomi.fi).Opens in a new window.
Testing
DVV may grant access to the test environment and the cooperation channels after the digital mail operator provides the contact information of its team and signs the necessary NDAs, after the appropriate security clearances are completed.
Before production use:
- test the implementation in accordance with DVV instructions
- verify compliance with the requirements
- correct any shortcomings.
5. Prepare for communications, customer guidance and support
Keep your users informed
A digital mail operator must ensure that its users do not misunderstand the operating logic of digital official messages. Aim for your users to understand both their rights and duties, regardless of which party provides them with the information and whether they are users of Suomi.fi Messages or the digital mail service. DVV does not join advertising campaigns of the digital mail operators.
Digital mail operators may use preferred DVV terminology to ensure uniform customer communications.
- Suomi.fi Messages is a centralised solution for public administration organisations to send messages to individuals and companies.
- A digital mail service can be used to read the Suomi.fi Messages inbox along with digital mail from other senders.
- A message, i.e. a digital official message, is a message in Suomi.fi Messages that can be read in all approved digital mail services. An individual may also receive digital messages from the authorities in other channels than Suomi.fi Messages. Please note: never use “Suomi.fi Message” for an individual message.
- The authorisation to display messages is granted by the user to the digital mail service, based on which the content of the user’s Suomi.fi Messages inbox can be shown in the digital mail service. The user grants this authorisation through the digital mail service, and it can be revoked in Suomi.fi Messages settings.
Customer service
Read more about arranging customer support with the DVV.
6. Begin production use
Agree on the details of starting production use with the DVV.
1. Indicate your interest
2. See if your service meets the requirements
Review the material and make sure that your service fully meets the requirements.
3. Sign the agreement with the DVV
Prepare to sign the agreement with the DVV.
4. Implement and test the integration
Implement the functionalities through the DVV’s APIs and test your implementation.
5. Prepare for communications, customer guidance and support
Make sure that your users are given enough information and support on activating and using the service.
6. Begin production use
Agree on the details of starting production use with the DVV.
Updated: 14/10/2026