MyDHLAPI onboarding process
Dear customer,
We appreciate your decision to integrate with MyDHLAPI, the comprehensive solution for all DHL Express service operations. In order to proceed with using the integration, it is essential to acquire credentials from DHL. These credentials can be easily requested on the DHL website.
Please keep in mind that having an account number is a prerequisite before initiating the onboarding process
Onboarding steps
Follow the below steps to receive credentials for your integration with MyDHLAPI
Step 1: Sign up for a developer account
- Go to
https://developer.dhl.com/
- Click on the “Sign Up” button to create a new account.
- Fill in the required information and agree to the the terms and conditions.
- Note the email adress used for this acccount can NOT be changed afterwards.
- Submit the registration form.
- After the registration form, DHL sends an email to set your password and to complete your developer registration.
- DHL sends an email how you can setup the password and complete the developer registration.
- Once the instructions in the email have been followed and your new password has been saved, click on the DHL logo in the top bar to go back to the home screen to continue with the next step.
Step 2: Create an application
Once you have signed up on the DHL website, you have to create an app to get access to the API(s)
- Click on the
Browse our APIs
button. - Search for
"MyDHLAPI"
in the top left search bar and click on the the resultDHL Express - MYDHLAPI
- Click on the
Get Access
button on the top right. - Fill in the required information
- At
Account Details
: provide your DHL account number - At
Requester company details
: provide the requester details.- NOTE: These details can be different from the account owner details. If so, click on ‘No’ at the question,
Are the Requestor Details the same as the DHL Account Owner details?
- If the account owner details are different from the requestor details, DHL also requests the address details of the account owner.
- NOTE: These details can be different from the account owner details. If so, click on ‘No’ at the question,
- At
How would you like to use the API?
:- select the option ‘I require credentials to DHL Express- MyDHL API for an existing plugin/ecommerce platform/third-party solution’.
- For Requestor platform name, fill in
ShipitSmarter
.
- At
Requested Services
: select the option(s) and fill in the expected usage and volume:Products
andShipment
for ordering shipments and retrieval of labels.Tracking
to receive tracking information for your DHL shipmentsPickup
to book pickup requestsRating
to receive shipping rates and transit times
- At
- Agree with the terms and conditions, which are the bottom two checkboxes.
- Submit the registration form.
- After submission, DHL shows a confirmation. Now you are able to see the onboarding status in the
My Apps Dashboard
Once your application is created, you are able to view the status of your credentials in the App dashboard
. In this dashboard, you are also able to find your user credentials once they are approved by DHL.
3. View status of onboarding request
Once your application is created, you are able to view the status of your credentials in the App dashboard
. In this dashboard, you are also able to find your user credentials once they are approved by DHL.
- You will see your newly created app in the list with apps with the status next to it.
- Click on the
Edit
button to see more details about your request. - According to DHL, it takes 2-5 working days to receive a response on the onboarding request. It is however recommended to also contact your account manager to possibly speed up the process.
- NOTE: Please also check the status of your onboarding with the account manager, as some countries are not aware of the portal and therefore are not using the portal.
4. Obtain API credentials
Once an approval has been received from DHL via email, you are able to obtain the API credentials via the developer portal.
- Log in with your developer account on
https://developer.dhl.com/
- Click on
Apps
- You will see your app in the list with apps with the status next to it.
- Click on the
Edit
button to see more details of your request. - This page shows the following information:
- The top section shows general information on your onboarding like the app name and the status
- The
Credential
section shows you the credentials required for using the API.- The API Key, is used as the username (Click on ‘Show key’ to show the actual value)
- The API Secret, is used as the password (Click on ‘Show key’ to show the actual value)
- The
APIs
section shows you for which environments the keys are enabled.- If your credentials have been enabled for Customer (Integration) testing, you are able to use the credentials in the playground environment.
- If your credentials have been enabled for Production (Global), you are able to use the credentials in the production environment.