Current information for our partners

2024-11-19

Starting April 30, 2025, Kivra will discontinue version 1 of Usermatch in our matching service.

Moving to v2 of Usermatch offers several advantages for you as an integrating partner. With Usermatch v2 you can match users against a verified email address and also companies against VAT number (VAT), in addition to matching on personnummer (SSN).

What do you need to do? Here are the two steps to go from v1 to v2:

1 Change the URL from /v1/tenant/{tenantKey}/usermatch to:

• /v2/tenant/{tenantKey}/usermatch/ssn
• /v2/tenant/{tenantKey}/usermatch/verified_email
• /v2/tenant/{tenantKey}/companymatch/vatnr

2 Change SSNs to LIST in the metadata for both request and response.

2024-11-01

We've made it even easier for you as a partner to integrate with Kivra Företag, which is used by over 175,000 companies. With the new integration, your customers can easily sign up for Kivra Företag directly within your system, and the integration is activated automatically. Your customers can then read and manage all their company mail – government letters and other important documents – directly within your system. This saves both time and hassle!

Want to learn more about how to integrate your system with Kivra Företag and the possibilities with a customized onboarding process for company mailboxes? Contact adrian.fickler(at)kivra.com!

2024-03-05

We have made it even easier for you as partner. From now on, you can use our user-match functionality for companies and organizations as well, i.e. when you match with an an organizational number.

More details here

2023-11-28

Vi vill uppmärksamma er på att Kivra kommer införa 3 viktiga förändringar i sender API, enligt nedan.

1. 31a maj 2024 kommer vi stänga v1/tenant/TENANT_ID/content och ber alla som är integrerade mot Kivras API att istället använda v2/tenant/TENANT_ID/content
2. I och med övergången till v2 blir attributen type and subject obligatoriska i metadatastrukturen för v2/tenant/TENANT ID/content
3. Vi tar bort [payment] metadatastrukturen. Dess funktionalitet kommer att ersättas med den redan existerande [payment_multiple_options] metadatastrukturen

Exempel av betalning i v1 och v2 av content endpoint

To ensure that you, as a partner, send correctly and always have support for our new and upcoming services, we recommend planning a transition to Kivra's Content API v2.

We have launched version 2 of our API, and to this version, we have transferred the following features:

• Responsive Design: Customize content based on the device it's displayed on. With HTML, we enable features like graphs, charts, dropdown menus, and carousels - a more sophisticated layout, in essence.
  
• Forms: Create and send forms through our 'Forms' API and collect valuable information from users.
  
• Email Matching: We now allow matching Kivra users based on email addresses, not just personal identification numbers as before.
  
• Campaigns by Tag: The ability to target campaigns based on your sender's own segmentation.

2023-09-05

The option to add a Campaign tag when sending content through our API is now available in beta version. The sender needs to activate a new metadata field to enable the use of a Campaign tag.

The campaign is created by adding a tag in 'Campaigns'. When content is sent through Kivra's content-API and a tag is added to the new metadata field, Kivra links the campaign if there's a match. This tag segmentation will then replace all other options in 'Campaigns'.

For more information, contact us.

2021-10-03

We want to notify you of the opportunity to use so-called incremental matching for Kivra’s API. It means that you (integrator/partner to Kivra) who uses our API – and have the right to access our user database – can request to download the changes in our user base for a customer (sender) in comparison to the previous lookup. This instead of, as earlier, having to download the complete user database for each sender, each time.

Read more

For further questions please contact: partner@kivra.com

2021-09-07

Batchintegrationen stängs ner 31 december 2022

Kivra har tagit beslut om att stänga ner all vår batch-integration. Det innebär att det – om en tid – inte längre kommer vara möjligt att exempelvis hämta user accept-filer eller skicka in filer till oss.

Varför görs förändringen?

Vi gör förändringen för att vi tillsammans med våra partners ska kunna introducera nya tjänster och funktionalitet som kräver realtidsinteraktion. Batch-lösningen är inte optimerad för det. Däremot stödjer Kivras API-tjänst nya funktioner till fullo.

Vad innebär det för partners?

För er som partner innebär det att ni behöver se över och förändra hela eller delar av er intergrationsuppsättning och istället övergå till vår API-tjänst. Vi förstår att det innebär extra arbete för er. Därför har vi satt en väl tilltagen deadline – 31 december, 2022.

Mer om förändringen

Det finns fler skäl till att vi överger batch-lösningen. Det primära att vi ökat vår utvecklingstakt på Kivra och flera betydande funktioner har inte fullt stöd i den äldre lösningen. En stor del av vår partner- och kundbas har redan gjort skiftet och vi vill såklart att ni ska ha samma förutsättningar att ta del av hela vårt produktutbud.

Frågor och plan för migrering?

Vi kommer vara behjälpliga med stöd för tekniska frågor under övergången. Vi bistår också gärna med en plan för er att migrera från batchlösningen till API-tjänsten. Frågor om övergången besvaras av er Partneransvarige. Ni hittar kontaktuppgifter till supporten längst ner på denna sida om ni behöver hjälp med att integrera via Kivras API.

As announced already one year ago via kivrastatus.se and mail (https://kivrastatus.se/details/b01e178293096) partners and senders should use the following API endpoints to communicate via Kivra:

• Production environment: sender.api.kivra.com (instead of api.kivra.com)
• Sandbox environment: sender.sandbox-api.kivra.com (instead of sandbox.kivra.com).

Partners and senders that have not updated the endpoint yet are required to proceed with the change as quickly as possible and no later than 31st October 2021.

For questions please contact partner@kivra.com or paolo.leva@kivra.com

For questions about how to integrate via our API, contact us here.