This guide will show you how to connect your DHL Express account to Easyship.
Steps to Connect Your DHL Express Account
1. On the Easyship dashboard, go to Couriers. Click Add new courier, choose the country where your DHL account is located, and select DHL Express.
2. Enter your Production Credentials Keys associated with your DHL Express account, provided by DHL. If you haven't received them via email, you can find them in your developer portal. Contact your DHL account manager for assistance if needed.
- Account Name: Add account nickname
- DHL Account Number: Add your DHL Express Account Number
- MyDHL API Secret: Add your DHL Express production API Secret
- MyDHL API Key: Add your DHL Express production API Key
3. Click Connect to complete the account connection. The DHL Express courier services will then be available, and you can start shipping
Changing Your Courier Settings on Easyship
Please note that Easyship does not know your contractual situation with the courier. You'll need to enter your pickup and DDP handling fees. If not provided, we assume:
- Pickup fee: $0
- DDP fee: HKD$100, US$10, Singapore$10, or AUD$10, depending on your DHL Express account origin.
You can change your courier account settings with these steps:
1. Go to the Courier Section under Your own courier accounts and select your DHL Express account.
2. Change the following fields as required and click Save.
- Account: Change the Displayed Account Name
- Settings: Pickup fee, DDP Handling fee
Common Connection Errors
- Invalid Credentials: The account number has 9 digits.
- Unregistered Account: You must have a registered DHL Express Account and valid DHL Express API Credentials.
- Unsupported Regions: We do not support DHL Express accounts from India and Brazil.
- Internal Server Error: Please contact support@easyship.com.
Registering on the DHL Developer Portal and Getting API Keys
To proceed with the connection, you need to have an API Key, an API Secret and an Export Account Number that you can retrieve by registering to the DHL Developer Portal if you don't have one yet.
1. Register on the DHL Developer Portal for a DHL Express Account. You need an API Key, API Secret, and Export Account Number, which you can retrieve from the portal under My Shipment Setting. The account number has 9 digits.
2. Fill this onboarding file to receive test credentials. Select "I require credentials to DHL Express – MyDHL API for an existing plugin/ecommerce platform/third-party solution" and add Easyship as the Requestor Platform Name.
3. Select all available services at Requested Services:
- Rating
- Products
- Shipment
- Tracking
- Pickup
- Address Validation
The field named Transaction volume per month is only useful to DHL for statistics purposes, therefore it won't influence you on the use of the API.
4. Submit the registration. DHL will notify you via email once the test access request is approved, followed by a second email with production credentials.
5. Request Production Credentials. Log in to your DHL Developer Portal, navigate to My Apps, and click on DHL EXPRESS – MYDHL API under App Name. Click Request Production Access, submit the request, and wait for the approval email from DHL.
6. Retrieve the Production API credentials and use them on Easyship. You can now log in to your DHL Developer profile where you will be able to view your App Status as approved.
7. Click on DHL EXPRESS – MYDHL API under App Name where you will need to click Request Production Access.
8. Click Submit and you will receive confirmation via email that the request has been sent and the local DHL team will approve it accordingly.
9. Retrieve the Production API credentials to use them on Easyship. You can find your API Key and Secret in the MyDHL Portal that can be used to connect your account on Easyship.
Your DHL account manager can help speed up the process. You can always contact us at support@easyship.com if you have any questions.