Articles in this section

Set up a connection to DHL

Tanisha Ray
Updated

DHL is a global logistics and shipping company renowned for its extensive network and reliable delivery services, catering to businesses and individuals worldwide.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type *  

Choose your DHL API type:

  • DHL eCommerce Europe: Connect to DHL's logistics network to create shipments, track parcels, and manage delivery services across Europe

  • DHL Express Global: Connect to DHL's international express network to create, manage, and track time-critical shipments across the globe

API type: DHL eCommerce Europe

Environment * 

Select your DHL account environment:

  • Sandbox: if your account URL is https://api-sandbox.dhl.com.

  • Production: if your account URL is https://api.dhl.com.

OAuth 2.0 client * 

Select the OAuth 2.0 client that stores the client ID and client secret provided to you by DHL.

How to retrieve the client ID and client secret 

To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit (pencil.svg) button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource

API type: DHL Express Global 

Environment * 

Select your DHL Express Global environment:

  • Sandbox: if your account URL is https://express.api.dhl.com/mydhlapi/test

  • Production: if your account URL is https://express.api.dhl.com/mydhlapi

Auth type * 

Select your DHL account authentication type (either Basic or Token).

Auth type: Basic 

Username * 

Enter your DHL account username.

Password * 

Enter your DHL account password.

Multiple layers of protection, including AES 256 encryption, are in place to keep your password safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

Auth type: Token 

Token * 

Enter your DHL account token.

Multiple layers of protection, including AES 256 encryption, are in place to keep your token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see OAuth 2.0 universal connector documentation.

How to retrieve the client ID and client secret

  1. Sign in to your DHL account. 

  2. Navigate to Profile > Apps.

  3. Click + Create app.

  4. Enter a Name.

  5. Select the APIs.

  6. Click Create app. You will be redirected to the Apps page.

  7. Click the app.

  8. Copy the API key (client ID).

  9. Copy the API secret (client secret).

Additional references