The DHL eCommerce API, minus the integration work

Connect your WMS, ERP, or e-commerce backend to Sendcloud's REST endpoint and the DHL eCommerce API integration is already running, alongside DHL Express, UPS, Royal Mail, and 170+ other couriers.

The DHL eCommerce API, minus the integration work

Connect your WMS, ERP, or e-commerce backend to Sendcloud's REST endpoint and the DHL eCommerce API integration is already running, alongside DHL Express, UPS, Royal Mail, and 170+ other couriers.

The DHL eCommerce API, minus the integration work

Connect your WMS, ERP, or e-commerce backend to Sendcloud's REST endpoint and the DHL eCommerce API integration is already running, alongside DHL Express, UPS, Royal Mail, and 170+ other couriers.

Easy to use and thoroughly documented

Tested on millions of shipments

Available on all plans

Why integrate DHL eCommerce via the Sendcloud API?

B2C e-commerce parcel across four markets

DHL eCommerce is Deutsche Post DHL Group's dedicated product for B2C parcel volumes. Sendcloud handles label creation and tracking for all four markets without separate DHL credentials per country.

Two routing modes per shipment

Direct Injection routes high-volume shipments via DHL’s sortation hubs rather than door pick-up. Sendcloud lets you select the routing mode per shipment in the label call.

Integrate with 170+ couriers at once

Stop maintaining and integrating different couriers and use one API for all.

GDPR Compliance

We comply with the GDPR rules to protect data and privacy in Europe.

API uptime of 99.99%

Reliable shipping software built on AWS and with leading market technologies.

ISO 27001 Certified

The world’s most rigorous standards for information security.

The complete shipping API for any system

Shipping API

Get rates, create shipments, download labels, configure webhooks and so much more.

Checkout API

Retrieve the list of active couriers, query service points by GPS location, and check their availability.

Pickup API

Schedule pickups to take place at the address of your choice.

Tracking API

Track parcels in real time, retrieve delivery time stamps, and consolidate statuses in an easy-to-read format.

Returns API

Build your own returns portal, find the nearest service point, create return shipments, and download return labels.

Contracts API

Create and update Sendcloud's shipping contracts or your own courier contracts via API.

"Sendcloud allows us to connect to a lot of different couriers seamlessly."

Oscar Ziegler

Founder and CEO

-

Hive

API integration examples

API Integration

See a basic example of an API integration using Python.

Service Point Picker

See how to integrate the Service Point Picker into a custom application.

Where do you start?

1

Set up your account

2

Get your free API key

3

Start sending requests to the DHL eCommerce API

Questions & answers

Why integrate the DHL eCommerce API via Sendcloud rather than directly?

Direct DHL eCommerce integration means handling two separate setups: DHL eCommerce Europe (Italy, France, Austria) with API ClientID, API Secret, EKP customer identification, and Direct Injection routing details; and DHL eCommerce UK with ClientID, ClientSecret, cut-off time, and a pick-up or returns account number.

Through Sendcloud, you authenticate once with your Sendcloud API key and use a single REST schema for DHL eCommerce alongside every other courier in your account. A direct DHL eCommerce contract is required for both regions; Sendcloud rates aren't offered for DHL eCommerce.

What happens when DHL eCommerce updates or breaks their API?

DHL eCommerce runs separate APIs for the European markets (Italy, France, Austria) and the UK. Direct integrators have to track changes across both, refresh credentials when authentication updates, and adjust payload structures when DHL makes changes.

When you ship DHL eCommerce through the Sendcloud REST API, the abstraction layer absorbs those changes. Sendcloud's engineering monitors both DHL eCommerce variants and updates the connectors internally. Your Sendcloud request schema stays consistent across DHL Parcel pickup, DHL Parcel pickup Saturday, and the European DHL eCommerce methods.

Can I use my own DHL eCommerce contract?

Yes, and you have to. DHL eCommerce requires direct contracts; Sendcloud rates aren't offered. Each region is a separate contract.

For DHL eCommerce Europe (Italy, France, Austria): go to Shipping > Couriers > My Contracts, find DHL eCommerce, click Add your own contract, and enter API ClientID, API Secret, Customer Identification (EKP Nr), and optional Customer Account Nr, Location ID, and Direct Injection details.

For DHL eCommerce UK: separate contract activation. Provide ClientID, ClientSecret, Cut-off time, and a Pick-up or Returns Account Number. A Lite plan or above is required for both.

See the DHL eCommerce Europe and DHL eCommerce UK contract activation articles.

Which DHL eCommerce products are supported through the API?

The integration covers both DHL eCommerce regional variants:

  • DHL eCommerce UK regular pickup methods: DHL Parcel pick-up - Next Day 0-5kg and 5-20kg; Saturday 0-5kg and 5-20kg

  • Northern Ireland: only DHL Parcel pick-up - 48 Hours Delivery

  • DHL eCommerce Europe: methods for Italy, France, and Austria, with method codes that depend on contract setup

  • Direct Injection routes (country, gateway city, postal code) for cross-border consolidation

The Sendcloud shipping-methods endpoint returns the up-to-date list. See the DHL eCommerce UK shipping conditions Help Centre article.

Which DHL eCommerce-specific features does the API expose?

DHL eCommerce-specific options exposed through the integration:

  • Regular pickup scheduling at no extra cost on Lite plans and above (minimum 5 parcels per pickup)

  • Cut-off time field on the contract: splits same-day vs next-day pickup assignment automatically based on label creation time

  • Direct Injection routing for European cross-border (gateway city + postcode)

  • Returns Account Number and Returns API Token for UK return labels (drop-off only)

  • Failed-delivery redirect in the UK: rescheduled or delivered to a safe place, neighbour, or DHL eCommerce UK ServicePoint

  • Northern Ireland routing constrained to the 48-hour delivery method

How do I track DHL eCommerce parcels?

DHL eCommerce tracking events flow through the same pipeline for both UK and Europe variants. Note: returns may show a "collection" scan in the tracking feed (the driver picking up from the drop-off location). This is expected and can be ignored.

All events normalise to Sendcloud's status taxonomy through GET https://panel.sendcloud.sc/api/v2/tracking/{tracking_number}, with the chronological history under statuses and each event mapped to parent_status. Subscribe to the parcel-status-changed webhook for push updates. Reference: Tracking parcels.

How do I create DHL eCommerce return labels?

DHL eCommerce UK returns are drop-off only. The contract must include a Returns Account Number and optional Returns API Token to generate return labels. Tracking may show a "collection" scan in the feed (the driver picking up from the drop-off location); this is expected. DHL eCommerce Europe returns depend on what’s enabled for your country contract.

All return labels are created through Sendcloud’s standalone v3 Returns API (synchronous or asynchronous; async is recommended for higher throughput). No outgoing parcel lookup or JWT tokens are required. Reference: Returns API overview.

How does Sendcloud's multi-carrier API compare to connecting couriers individually?

The Sendcloud REST API gives you access to 170+ couriers, including DHL eCommerce, through one credential set, one schema, one webhook stream, and one error model. Connecting couriers individually means handling separate authentication, payload formats, and tracking systems for each, and redoing the work every time a courier ships breaking changes upstream.

With Sendcloud, you ship DHL eCommerce alongside DHL, UPS, PostNL, and Royal Mail, or any other courier in your account using the same code. Route shipments between couriers based on rules (weight, destination, service level, cost) without writing courier-specific routing logic. Fall back to alternative couriers automatically if DHL eCommerce's upstream system has issues.

Adding a new courier later means adding it to your Sendcloud account, not building a new integration.

Questions & answers

Why integrate the DHL eCommerce API via Sendcloud rather than directly?

Direct DHL eCommerce integration means handling two separate setups: DHL eCommerce Europe (Italy, France, Austria) with API ClientID, API Secret, EKP customer identification, and Direct Injection routing details; and DHL eCommerce UK with ClientID, ClientSecret, cut-off time, and a pick-up or returns account number.

Through Sendcloud, you authenticate once with your Sendcloud API key and use a single REST schema for DHL eCommerce alongside every other courier in your account. A direct DHL eCommerce contract is required for both regions; Sendcloud rates aren't offered for DHL eCommerce.

What happens when DHL eCommerce updates or breaks their API?

DHL eCommerce runs separate APIs for the European markets (Italy, France, Austria) and the UK. Direct integrators have to track changes across both, refresh credentials when authentication updates, and adjust payload structures when DHL makes changes.

When you ship DHL eCommerce through the Sendcloud REST API, the abstraction layer absorbs those changes. Sendcloud's engineering monitors both DHL eCommerce variants and updates the connectors internally. Your Sendcloud request schema stays consistent across DHL Parcel pickup, DHL Parcel pickup Saturday, and the European DHL eCommerce methods.

Can I use my own DHL eCommerce contract?

Yes, and you have to. DHL eCommerce requires direct contracts; Sendcloud rates aren't offered. Each region is a separate contract.

For DHL eCommerce Europe (Italy, France, Austria): go to Shipping > Couriers > My Contracts, find DHL eCommerce, click Add your own contract, and enter API ClientID, API Secret, Customer Identification (EKP Nr), and optional Customer Account Nr, Location ID, and Direct Injection details.

For DHL eCommerce UK: separate contract activation. Provide ClientID, ClientSecret, Cut-off time, and a Pick-up or Returns Account Number. A Lite plan or above is required for both.

See the DHL eCommerce Europe and DHL eCommerce UK contract activation articles.

Which DHL eCommerce products are supported through the API?

The integration covers both DHL eCommerce regional variants:

  • DHL eCommerce UK regular pickup methods: DHL Parcel pick-up - Next Day 0-5kg and 5-20kg; Saturday 0-5kg and 5-20kg

  • Northern Ireland: only DHL Parcel pick-up - 48 Hours Delivery

  • DHL eCommerce Europe: methods for Italy, France, and Austria, with method codes that depend on contract setup

  • Direct Injection routes (country, gateway city, postal code) for cross-border consolidation

The Sendcloud shipping-methods endpoint returns the up-to-date list. See the DHL eCommerce UK shipping conditions Help Centre article.

Which DHL eCommerce-specific features does the API expose?

DHL eCommerce-specific options exposed through the integration:

  • Regular pickup scheduling at no extra cost on Lite plans and above (minimum 5 parcels per pickup)

  • Cut-off time field on the contract: splits same-day vs next-day pickup assignment automatically based on label creation time

  • Direct Injection routing for European cross-border (gateway city + postcode)

  • Returns Account Number and Returns API Token for UK return labels (drop-off only)

  • Failed-delivery redirect in the UK: rescheduled or delivered to a safe place, neighbour, or DHL eCommerce UK ServicePoint

  • Northern Ireland routing constrained to the 48-hour delivery method

How do I track DHL eCommerce parcels?

DHL eCommerce tracking events flow through the same pipeline for both UK and Europe variants. Note: returns may show a "collection" scan in the tracking feed (the driver picking up from the drop-off location). This is expected and can be ignored.

All events normalise to Sendcloud's status taxonomy through GET https://panel.sendcloud.sc/api/v2/tracking/{tracking_number}, with the chronological history under statuses and each event mapped to parent_status. Subscribe to the parcel-status-changed webhook for push updates. Reference: Tracking parcels.

How do I create DHL eCommerce return labels?

DHL eCommerce UK returns are drop-off only. The contract must include a Returns Account Number and optional Returns API Token to generate return labels. Tracking may show a "collection" scan in the feed (the driver picking up from the drop-off location); this is expected. DHL eCommerce Europe returns depend on what’s enabled for your country contract.

All return labels are created through Sendcloud’s standalone v3 Returns API (synchronous or asynchronous; async is recommended for higher throughput). No outgoing parcel lookup or JWT tokens are required. Reference: Returns API overview.

How does Sendcloud's multi-carrier API compare to connecting couriers individually?

The Sendcloud REST API gives you access to 170+ couriers, including DHL eCommerce, through one credential set, one schema, one webhook stream, and one error model. Connecting couriers individually means handling separate authentication, payload formats, and tracking systems for each, and redoing the work every time a courier ships breaking changes upstream.

With Sendcloud, you ship DHL eCommerce alongside DHL, UPS, PostNL, and Royal Mail, or any other courier in your account using the same code. Route shipments between couriers based on rules (weight, destination, service level, cost) without writing courier-specific routing logic. Fall back to alternative couriers automatically if DHL eCommerce's upstream system has issues.

Adding a new courier later means adding it to your Sendcloud account, not building a new integration.

Questions & answers

Why integrate the DHL eCommerce API via Sendcloud rather than directly?

Direct DHL eCommerce integration means handling two separate setups: DHL eCommerce Europe (Italy, France, Austria) with API ClientID, API Secret, EKP customer identification, and Direct Injection routing details; and DHL eCommerce UK with ClientID, ClientSecret, cut-off time, and a pick-up or returns account number.

Through Sendcloud, you authenticate once with your Sendcloud API key and use a single REST schema for DHL eCommerce alongside every other courier in your account. A direct DHL eCommerce contract is required for both regions; Sendcloud rates aren't offered for DHL eCommerce.

What happens when DHL eCommerce updates or breaks their API?

DHL eCommerce runs separate APIs for the European markets (Italy, France, Austria) and the UK. Direct integrators have to track changes across both, refresh credentials when authentication updates, and adjust payload structures when DHL makes changes.

When you ship DHL eCommerce through the Sendcloud REST API, the abstraction layer absorbs those changes. Sendcloud's engineering monitors both DHL eCommerce variants and updates the connectors internally. Your Sendcloud request schema stays consistent across DHL Parcel pickup, DHL Parcel pickup Saturday, and the European DHL eCommerce methods.

Can I use my own DHL eCommerce contract?

Yes, and you have to. DHL eCommerce requires direct contracts; Sendcloud rates aren't offered. Each region is a separate contract.

For DHL eCommerce Europe (Italy, France, Austria): go to Shipping > Couriers > My Contracts, find DHL eCommerce, click Add your own contract, and enter API ClientID, API Secret, Customer Identification (EKP Nr), and optional Customer Account Nr, Location ID, and Direct Injection details.

For DHL eCommerce UK: separate contract activation. Provide ClientID, ClientSecret, Cut-off time, and a Pick-up or Returns Account Number. A Lite plan or above is required for both.

See the DHL eCommerce Europe and DHL eCommerce UK contract activation articles.

Which DHL eCommerce products are supported through the API?

The integration covers both DHL eCommerce regional variants:

  • DHL eCommerce UK regular pickup methods: DHL Parcel pick-up - Next Day 0-5kg and 5-20kg; Saturday 0-5kg and 5-20kg

  • Northern Ireland: only DHL Parcel pick-up - 48 Hours Delivery

  • DHL eCommerce Europe: methods for Italy, France, and Austria, with method codes that depend on contract setup

  • Direct Injection routes (country, gateway city, postal code) for cross-border consolidation

The Sendcloud shipping-methods endpoint returns the up-to-date list. See the DHL eCommerce UK shipping conditions Help Centre article.

Which DHL eCommerce-specific features does the API expose?

DHL eCommerce-specific options exposed through the integration:

  • Regular pickup scheduling at no extra cost on Lite plans and above (minimum 5 parcels per pickup)

  • Cut-off time field on the contract: splits same-day vs next-day pickup assignment automatically based on label creation time

  • Direct Injection routing for European cross-border (gateway city + postcode)

  • Returns Account Number and Returns API Token for UK return labels (drop-off only)

  • Failed-delivery redirect in the UK: rescheduled or delivered to a safe place, neighbour, or DHL eCommerce UK ServicePoint

  • Northern Ireland routing constrained to the 48-hour delivery method

How do I track DHL eCommerce parcels?

DHL eCommerce tracking events flow through the same pipeline for both UK and Europe variants. Note: returns may show a "collection" scan in the tracking feed (the driver picking up from the drop-off location). This is expected and can be ignored.

All events normalise to Sendcloud's status taxonomy through GET https://panel.sendcloud.sc/api/v2/tracking/{tracking_number}, with the chronological history under statuses and each event mapped to parent_status. Subscribe to the parcel-status-changed webhook for push updates. Reference: Tracking parcels.

How do I create DHL eCommerce return labels?

DHL eCommerce UK returns are drop-off only. The contract must include a Returns Account Number and optional Returns API Token to generate return labels. Tracking may show a "collection" scan in the feed (the driver picking up from the drop-off location); this is expected. DHL eCommerce Europe returns depend on what’s enabled for your country contract.

All return labels are created through Sendcloud’s standalone v3 Returns API (synchronous or asynchronous; async is recommended for higher throughput). No outgoing parcel lookup or JWT tokens are required. Reference: Returns API overview.

How does Sendcloud's multi-carrier API compare to connecting couriers individually?

The Sendcloud REST API gives you access to 170+ couriers, including DHL eCommerce, through one credential set, one schema, one webhook stream, and one error model. Connecting couriers individually means handling separate authentication, payload formats, and tracking systems for each, and redoing the work every time a courier ships breaking changes upstream.

With Sendcloud, you ship DHL eCommerce alongside DHL, UPS, PostNL, and Royal Mail, or any other courier in your account using the same code. Route shipments between couriers based on rules (weight, destination, service level, cost) without writing courier-specific routing logic. Fall back to alternative couriers automatically if DHL eCommerce's upstream system has issues.

Adding a new courier later means adding it to your Sendcloud account, not building a new integration.

One API for all your shipping needs

No set-up fees

Same-day integration

Ship with Europe’s top couriers