---
title: "Kivra delivery now available in the Mass Printing Service"
canonical: https://documentation.maventa.com/changelogs/product-changelog/2026-04-27-kivra-delivery-in-mass-printing-service/
---

The Mass Printing Service (Payslip) now supports Kivra as a digital delivery channel. When you send a letter through the Mass Printing API, Maventa automatically checks whether the recipient has a Kivra digital mailbox. If a match is found, the letter is delivered to Kivra instead of being printed and mailed — saving printing and postage costs while reaching recipients in their preferred channel.

> [!NOTE]
> The Mass Printing Service is available only for Finnish companies.

## How it works

Before handing a letter over to the print provider, Maventa performs a lookup against the Kivra consumer registry using the recipient's information. If a match is found, the letter is delivered digitally. If no match is found, the letter continues to the normal print route — no changes are needed on your end.

The lookup uses 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

> [!NOTE]
> To improve match rates, provide as much recipient information as possible in your API calls. The JSON API supports optional `recipient[email]`, `recipient[phone]`, and `recipient[ssn]` parameters that enable additional lookup methods beyond name and address matching. If you are still using the IPOST XML API, we recommend switching to the JSON API — it removes the need to build iPost XML metadata and ZIP packages, supports more Kivra matching criteria, and offers additional features like custom letter subjects.

Kivra has a maximum PDF size limit of 15 MB. If the letter exceeds this limit, it falls through to the normal print route automatically.

## Automatic sender setup

Each company can have only one sender account (tenant) in Kivra. If a tenant does not already exist, Maventa automatically creates one when the company's first letter is delivered via Kivra — no action is required. The tenant name is based on the company's official name from the YTJ registry.

## Custom letter subject

When using the JSON API, you can customise the subject that recipients see in their Kivra inbox using the `letter_subject` parameter. By default, the subject is "Kirje lähettäjältä [company name]".

## Opting out of digital delivery

If a specific letter requires guaranteed physical delivery — for example, when a paper trail is needed — set the `prevent_digital_post` parameter to `true`. This opts out of both Kivra and OmaPosti delivery for that letter.

## Billing

Kivra deliveries are billed as consumer invoices. The billing action name is `EINVOICE_KIVRA_FI`.

## Learn more

For full technical details, see the [Mass Printing Service documentation](https://documentation.maventa.com/services-and-reach/finland/mass-printing-service/#kivra-delivery).