DOCS
HomeGlobal ecommerce Fulfillment Carriers Connect via API

Connect DHL Carrier Account

Securely connect your DHL carrier account to access negotiated shipping rates and create labels directly through Zonos.

Get started 

The DHL carrier account connection process validates your credentials and ensures your account is properly configured to retrieve rates and generate shipping labels. When you connect your DHL account, Zonos performs a test rating call to verify the connection is working correctly before storing your credentials.

To register with DHL Express or set up through your Zonos Dashboard, follow the steps in this guide.

How DHL carrier account connection works 

Connecting your DHL carrier account:

  • Validates that you've provided the correct credential types for DHL
  • Makes a live rating call to the DHL API to confirm the credentials are valid
  • Stores your connected account in Zonos for future shipment rating and label creation
  • Returns the connected account details, including your DHL account information and rate type

Once connected, your DHL carrier account can be used to get real-time shipping rates based on your negotiated rates (if applicable) and create DHL shipping labels.

Connect your DHL account 

Use the carrierAccountConnect mutation to connect your DHL carrier account with your credentials.

Mutation

Use this mutation to connect your DHL carrier account and validate your credentials.

1mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) {
2 carrierAccountConnect(input: $input) {
3 errors
4 carrierAccount {
5 credentialProvider
6 id
7 integrationType
8 organization
9 rateType
10 carrier {
11 id
12 code
13 name
14 }
15 credentials {
16 type
17 value
18 }
19 }
20 }
21}

Variables

The mutation requires the DHL carrier code, rate type, and your DHL account credentials.

1{
2 "input": {
3 "carrierCode": "DHL",
4 "rateType": "NEGOTIATED",
5 "credentials": [
6 {
7 "type": "API_KEY",
8 "value": "actual_api_key_value"
9 },
10 {
11 "type": "API_PASSWORD",
12 "value": "actual_api_password_value"
13 },
14 {
15 "type": "ACCOUNT_NUMBER",
16 "value": "actual_account_number_value"
17 }
18 ]
19 }
20}

DHL requires the following credential types:

  • API_KEY - Your DHL API key
  • API_PASSWORD - Your DHL API password
  • ACCOUNT_NUMBER - Your DHL account number

You can find these credentials in your DHL account portal or by contacting your DHL account representative.

Response examples

Successful connection

When credentials are valid and DHL returns rates successfully:

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [],
5 "carrierAccount": {
6 "credentialProvider": "ORGANIZATION",
7 "id": "carrier_account_123",
8 "integrationType": "REST",
9 "organization": "organization_id",
10 "rateType": "NEGOTIATED",
11 "carrier": {
12 "id": "carrier_123",
13 "code": "dhl",
14 "name": "DHL"
15 },
16 "credentials": [
17 {
18 "type": "API_KEY",
19 "value": "actual_api_key_value"
20 },
21 {
22 "type": "API_PASSWORD",
23 "value": "actual_api_password_value"
24 },
25 {
26 "type": "ACCOUNT_NUMBER",
27 "value": "actual_account_number_value"
28 }
29 ]
30 }
31 }
32 }
33}

Error: Unsupported credential type

If you provide a credential type that DHL doesn't support:

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [
5 "Credential type SITE_ID is not supported by carrier DHL"
6 ],
7 "carrierAccount": null
8 }
9 }
10}

Error: Invalid credentials

If the credentials are valid types but don't authenticate successfully with DHL:

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [
5 "Failed to get rating from DHL API"
6 ],
7 "carrierAccount": null
8 }
9 }
10}

What happens after connection

Once your DHL carrier account is successfully connected:

  • The account is stored in your organization and linked to your credentials
  • You can retrieve DHL shipping rates using your negotiated rates (when applicable)
  • You can create DHL shipping labels through the Zonos API
  • The carrier account can be used across multiple shipments without reconnecting

Next steps 

After connecting your DHL carrier account:

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

Was this page helpful?

Get support·Legal docs·© 2026 Zonos
On this page:
  • Connect DHL Carrier Account
  • Get started
  • How DHL carrier account connection works
  • Connect your DHL account
  • Next steps