What is it?
DHL Express is a global express courier integrated with Ingrid for checkout, booking, and tracking. The integration supports a range of DHL Express products — see DHL Express on carrier.ingrid.com for the full list with per-product coverage, capabilities, and country routes.
This article covers DHL Express specifically. DHL Freight, DHL E-commerce, and DHL Paket are separate integrations with their own setup paths.
How credentials work for DHL Express
DHL Express in Ingrid uses different credentials models depending on the function:
Function | Credentials model | Merchant action |
Checkout | Ingrid-unified | None — Ingrid handles authentication centrally |
Booking | Merchant-owned | Provide credentials from the DHL developer portal (see Initial setup below) |
Tracking | Ingrid-unified (DHL Unified) | None — Ingrid handles authentication centrally |
For most merchants, this means you only need to take action for booking. Once booking credentials (including your DHL account number) are configured, checkout and tracking both work automatically.
Initial setup (booking)
To book shipments via DHL Express through Ingrid, you need API credentials from the DHL developer portal (DPDHL). The credentials apply across all DHL Express shipping methods — you don't need separate credentials per method.
What you'll provide
DHL Express MyDHL API username (also called API key)
DHL Express MyDHL API password (also called API secret)
Your DHL account number
How to get credentials from DHL
Register a login at the DPDHL developer portal: developer.dhl.com/user/register
Sign in and navigate to the DHL Express API page: developer.dhl.com/api-reference/dhl-express-mydhl-api
Click Get Access at the top right
Fill in your DHL account number and company details
In the request, state that you need credentials for the Ingrid third-party solution, and that the use case is Shipment
Once DHL provisions the credentials, share them with your Ingrid team to configure in Ingrid
What if something goes wrong?
Symptom | Likely cause | What to check |
Booking fails with 401 unauthorized | Credentials incorrect, regenerated, or revoked by DHL | Re-verify credentials in the DHL developer portal; update them in Ingrid |
Cannot get credentials from DHL | Account access issue or missing details | Contact DHL Express e-commerce support: |
Checkout works but bookings fail | Booking credentials not yet provided to Ingrid | Complete the booking credentials setup above |
Tracking events not coming through | Generic account setup issue or mismatch | Contact your Ingrid team to check that account setup and tracking configuration were completed |
For other DHL Express integration issues, contact your Ingrid CSM.
FAQ
Q: Do I need DHL credentials to show delivery options at checkout?
A: No. For checkout, Ingrid uses its own shared credentials with DHL Express. No merchant credentials are required for the checkout function.
Q: Why do I need credentials for booking but not for checkout?
A: Booking creates a shipment and label against your specific DHL account — this can only happen with your own credentials. Checkout fetches rate and option data, which Ingrid handles centrally using shared credentials.
Q: Where do I get DHL Express credentials?
A: From the DPDHL developer portal at developer.dhl.com — see the step-by-step above. The credentials you receive are sometimes called "MyDHL API" credentials.
Q: Can I use the same credentials across all DHL Express shipping methods?
A: Yes. Booking credentials apply across all DHL Express shipping methods you use — no need to enter them separately per method.
Q: What happens if DHL rotates my credentials?
A: Update them in Ingrid's carrier configuration when the rotation happens. For checkout and tracking (Ingrid-unified models), Ingrid handles rotation centrally — no merchant action needed.
Q: Who do I contact for DHL Express integration issues?
A: For credential issues from DHL, contact DHL Express e-commerce support at [email protected]. For Ingrid integration issues or to coordinate setup, contact your Ingrid CSM.
Related
Carrier library — overview of Ingrid's carrier coverage
Carrier credentials in Ingrid — how carrier credentials work