26.03.2026 - Introducing Kivra delivery & a new API for the Mass Printing Service (Payslip)

1. Kivra is coming to Mass Printing

Starting 27.4.2026, Kivra will be available as a digital delivery option within the Mass Printing service.

What is Kivra?

Kivra is a Finnish digital mailbox service where consumers choose to receive their letters, invoices, and other documents electronically. Kivra has been part of our consumer invoice delivery routing for a while now and now we are extending that same capability to cover the Mass Printing service. When a recipient has a Kivra account, they have actively opted in, meaning they prefer to receive their mail digitally. Delivering there is not only more convenient for them, it also reduces sender’s printing and postage costs.

Learn more about Kivra

How it works

Before a letter is handed over to the print provider, we perform an automatic lookup against the Kivra consumer registry using the recipient's information. If a match is found, the letter is delivered to the recipient's Kivra inbox instead of being printed and mailed. If no match is found, delivery falls through to the normal print route as usual. No disruption, no changes needed on your end.

The lookup is performed using the following recipient data (in priority order):

1. Social security number (SSN)
2. Email address
3. Full name + street address + postal code + post office
4. Full name + phone number

When a company sends its first letter via Kivra, we automatically set up a sender account (tenant) for them in Kivra if one doesn’t exist yet. No actions needed from the sender’s side. The tenant represents the company as a recognised sender within Kivra, so that recipients can see who their mail is from and, if they wish, manage their delivery preferences per sender.

Please note that Kivra has a maximum PDF size limit of 10 MB. If the letter exceeds this, it will fall through to the normal print route automatically.

Do you need to do anything?

For most of you no action is required. If your current integration already provides the recipient's full name and postal address (as it should), the Kivra lookup will work automatically. 

For better recipient matching and higher digital delivery rates, we recommend migrating to the new JSON API. It allows you to provide additional recipient details (such as SSN, email, and phone number) that significantly improve Kivra match rates.

If for any reason you need to force physical delivery for a specific letter, for example in cases where you need a guaranteed paper trail, you can set the prevent_digital_post parameter to true in your API call to opt out of Kivra (and OmaPosti) delivery for that letter.

Billing for Kivra sends
Kivra sends are billed from direct customers and partners as the price of a consumer e-invoices. The billing action name is:

EINVOICE_KIVRA_FI

2. New JSON API - replacing IPOSTXML

Alongside the Kivra launch, we want to highlight our new JSON-based API for sending Mass Printing letters. This is now the recommended way to send letters!

Why switch?

The new API is simpler to work with, you send a PDF file along with recipient and sender parameters as a standard multipart form request, with no ZIP packaging or XML metadata files required. It also gives you more flexibility to provide additional recipient details, which directly improves Kivra match rates:

The new API also lets you customise the letter subject that the recipient sees in their Kivra inbox. By default, the subject is "Kirje lähettäjältä [company name]", but you can override it with the letter_subject parameter.

In other words: by switching to the JSON API and supplying richer recipient data, you maximise the chances of your letters being delivered digitally via Kivra, saving on print costs and reaching recipients in the channel they prefer.

Full API details are in the Mass Printing Service documentation.

Summary

If you have any questions, don't hesitate to reach out to us. 

Best regards,

The Maventa Team