You can use this carrier with your own account starting from our Professional subscription.


In this article you will learn how to activate DHL Online Retoure in your DHL Business Customer Portal and how to store your contract data in your shipcloud account.

In this article 👇

  1. Activate DHL Online Retoure in the DHL Business Customer Portal

    1. Activation for "API Retoure" by DHL

    2. Assign "Retoure" authorization to your DHL user

    3. Copy receiver ID from the DHL Business Customer Portal

  2. Store contract data for DHL Online Retoure in your shipcloud account

    1. Registration with shipcloud from August 02, 2022

    2. Registration with shipcloud before August 02, 2022


Activate DHL Online Retoure in the DHL Business Customer Portal

1. Activation for the "API Retoure" by DHL

First check in your DHL Business Customer Portal whether you have made the necessary activations for DHL Online Returns or API Retoure. If you are not sure, please contact your DHL account manager.

Good to know: If the DHL Business Customer Portal login page is not automatically displayed in English, you can change the language by scrolling all the way down to "Sprachauswahl" ("Language Selection)".

2. Assign the "Retoure" authorization to your DHL user

After logging in, click on your name in the upper right corner to open your account settings menu and click on "Manage Users" to open your user overview.



Now edit the user that you have already configured for creating DHL Standard shipments. Click on the pencil icon to edit the settings for this user.



Now assign "Retoure" permission to this specific user. Simply click on "Retoure" in the menu item "Berechtigungen" ("Roles") and assign the permission by clicking on the arrow pointing to the right. Now click on "Save" so that your changes are applied. The return functionality is now enabled for your user.



3. Copy receiver ID from the DHL Business Customer Portal

For the configuration in your shipcloud account, you will need your receiver ID, which you can find under the menu item "Returns>> Settings>>Recipient and country overview".




Store contract data for DHL Online Retoure in your shipcloud account

You can easily store your contract data in your shipcloud account. You will need the following data for DHL Online Retoure:

  • Receiver ID (returns recipient)

  • Username/password

Based on the time of your registration with shipcloud, we provide you below with further information on how to store your access data for DHLRetoure in the shipcloud WebUI.



Registration with shipcloud from August 02, 2022

Log into your shipcloud account or the shipcloud WebUI and select the menu item "Carriers" in the navigation bar on the left to open your DHL configuration and enter your receiver ID as well as your user name and password in the "Returns" tab.

Good to know: If you leave the username and password fields blank, we will use the username and password from the "Access data" section in your DHL configuration. Click the green "Save & activate" button on the right to have your changes applied.

📌 Please note that previously saved data will be overwritten and you will ship using your own business rates after successful activation. The shipcloud business rates for DHL will then no longer be available to you.

Registration with shipcloud before August 02, 2022

If you have registered with shipcloud before August 2, 2022, please contact our support team first and we will activate your own configuration for DHL.

After activation, you will receive a confirmation email from us and can then enter your receiver ID, user name and password in your DHL configuration in your shipcloud account under "Configurations" >> "Carriers" >> "DHL". Click on the green "OK" button on the right to save your changes.

Good to know: If you leave the username and password fields blank, we will use the username and password from the "Default" section in your DHL configuration.

📌 Please note that once you have activated your own DHL configuration, you will no longer have access to the shipcloud business rates for DHL.

📌 Please note that only national returns within Germany are possible with DHL Online Retoure. With DHL Retoure you can also offer your customers DHL's mobile QR code return.


Any further questions? We're happy to help.


These articles might also interest you 👇

DHL: Overview of the connection with shipcloud

DHL: Shipping via your own carrier contract

DHL: Available additional services for shipping via your own carrier contract

How to create returns / return labels

shipcloud Return Portal

Did this answer your question?