---
title: "How to connect Magyar Posta"
description: "Connect Magyar Posta (MPL) to ShipDock to offer Hungarian post offices, partner points and MPL parcel lockers and to create MPL labels."
url: https://help.shipdockapp.eu/en/articles/11764748-how-to-connect-magyar-posta
collection: "Couriers"
updated: 2026-11-19
language: en
---

# How to connect Magyar Posta

Connect Magyar Posta (MPL) to ShipDock to offer Hungarian post offices, partner points and MPL parcel lockers and to create MPL labels.

For shops in Hungary that ship with Magyar Posta (MPL): post offices, partner points and MPL parcel lockers for customers, MPL labels for you.

## Before you start

-   A business contract with MPL and an ÉnPostám account with API access for your company (see the next section).
    
-   For cash on delivery: the 24-digit number of the bank account where MPL should pay out COD money.
    
-   Plan: **Lite** to connect Magyar Posta and show pickup points, **Full** to create labels.
    
-   No test mode. Every label you create is a real shipment.
    

## Get API access from MPL

MPL sets up API access, not ShipDock. The process as MPL described it:

1.  The person who will manage the API keys registers in ÉnPostám (MyPost) as a private individual, unless they already have an account.
    

![MyPost: Register as a private individual](https://staticfiles.gleap.io/ghelparticle/O9URMtYZ8YrSLgPG4JhEsdFLLZL7tXfnBVYkMssIFJgu9ptwwQuAbi8prCkiUiH94SyEz7fRIxf.png)

2.  On the [MPL API](https://www.posta.hu/mplapi_eng) page, open **Registration**, fill in the Excel form with that person's and the company's details, and email it to kwradmin@posta.hu.
    

![MPL API page: Registration](https://staticfiles.gleap.io/ghelparticle/ZGa15pCoMGKLZabrEb2jGdHxoKfBKNKjhpC8yWjo57C54uk8Fl15AH90HflL25BUkbhJi5GleK0.png)

3.  After MPL's confirmation email, the person logs in to the developer portal at [devportal.posta.hu/devapps](https://devportal.posta.hu/devapps) with their ÉnPostám login and switches to the company view.
    

![Developer Portal: Log in with the MyPost account](https://staticfiles.gleap.io/ghelparticle/ZeNlPo3bWMOnN3B0TVKImeQZylXl05YI5gpuCAXEaktoitUSRMBN3MH7RA1GkIDRoGQahqVIgCt.png)![Choose the company view](https://staticfiles.gleap.io/ghelparticle/PrnYyOysLZLTkTFolzE7MhG6nPk11LlHMdTAEuWAdD9gh3MQm61cM01JnRCLXTJku2odSdumvrp.png)

4.  At the bottom of the page they copy the production key pair: API Key and API Secret.
    

![API Key and API Secret in the prod environment](https://staticfiles.gleap.io/ghelparticle/LH8HhbwUHJ8UCfZf1c6FuK33s6VuPZnkJ6aOK0hPST6i0cYhjm61JXWGKqYUGBJCOPbaVW9CF0L.png)

## Connect Magyar Posta

1.  Open **Providers**, click **Create provider** and choose **Hungary** in the country selector.
    
2.  On the **Magyar Posta** card, click **Select**.
    
3.  In the **Connection** card, turn on **Connect provider throught API**.
    
4.  Enter **Api Key** and **Api Secret** (developer portal, company view), **Accounting code** (developer portal, Applications page) and **Agreement** (your agreement code from ÉnPostám or your MPL contract).
    
5.  In **Sender details**, fill in **Name**, **Organization**, **Street**, **City**, **ZIP Code**, **Phone** and **Email**. The phone must be a Hungarian number in international format, for example +36201234567.
    
6.  For COD: in **COD Details**, enter the **Account number**, the sender's 24-digit bank account number.
    
7.  In the **Status** panel, choose **Active** and click **Save**.
    

Then set up the rates on the **Pickup points** and **Home delivery** tabs: see [How to set up shipping rates](https://help.shipdockapp.eu/en/articles/11764754.md). For home delivery, choose the service **Business Parcel**.

## Pickup points

Post offices, partner points and MPL parcel lockers in Hungary. To hide a type, use the **Exclusion** card on the **Pickup points** tab: **Parcelshop**, **MagyarPosta box**.

Magyar Posta pickup points work only with the widget display mode **List with Map**: see [How to choose the pickup point widget display mode](https://help.shipdockapp.eu/en/articles/11530648.md).

## What works with Magyar Posta

-   **Home delivery**: Yes, **Business Parcel**
    
-   **Pickup points**: Yes, Hungary
    
-   **Cash on delivery (COD)**: Yes, needs the **Account number** in **COD Details**
    
-   **Mark COD as paid automatically**: No
    
-   **Cancel from the app**, **Test mode**: No
    
-   **Insurance**: Yes, per order: **Edit order** → **Override insurance value**
    
-   **Label formats**: PDF, **Labels, A6 on A6** and **Labels, A6 on A4, 4pcs/page**
    

## Limits

-   Shipping within Hungary only.
    
-   Mark COD orders as paid in Shopify yourself after MPL pays you.
    
-   Deleting a parcel in **Orders** removes it only from ShipDock. Cancel the shipment with MPL as well.
    

## Troubleshooting

-   **Label creation fails with an error about the sender phone.** Enter the phone as +36 followed by the number, without spaces.
    
-   **Label creation fails for a COD order.** Check that **Account number** in **COD Details** has exactly 24 digits.
    
-   **Authentication error.** Check that **Api Key** and **Api Secret** are the production pair from the company view, not a personal or test key.
    

For errors that apply to every courier, see [How to connect a courier](https://help.shipdockapp.eu/en/articles/11764762.md).

## Related articles

-   [How to set up shipping rates](https://help.shipdockapp.eu/en/articles/11764754.md)
    
-   [How to set up cash on delivery (COD)](https://help.shipdockapp.eu/en/articles/9579888.md)
    
-   [How to choose the pickup point widget display mode](https://help.shipdockapp.eu/en/articles/11530648.md)

## Related

- [How to connect a courier](https://help.shipdockapp.eu/en/articles/11764762-how-to-connect-a-courier.md)
- [Supported couriers and what each one can do](https://help.shipdockapp.eu/en/articles/11764763-supported-couriers-and-what-each-one-can-do.md)
- [How to connect Balíkovna and Česká pošta](https://help.shipdockapp.eu/en/articles/11764744-how-to-connect-balikovna-and-ceska-posta.md)
- [How to connect BoxNow](https://help.shipdockapp.eu/en/articles/11764755-how-to-connect-boxnow.md)
- [How to connect DHL Express](https://help.shipdockapp.eu/en/articles/11764765-how-to-connect-dhl-express.md)
