DHL

Short description

Pull tracking information directly from DHL into armin.cx and use it in workflows (for example WISMO). The connection is set up by creating an app in the DHL Developer Portal and pasting the generated API credentials into armin.cx.

Watch the following Loom on how to integrate, or follow the detailed steps down below:

When to use this

When DHL shipment status should be available in armin.cx, for example for WISMO flows, automated replies to "Where is my order?" questions, or rule-based workflows that branch on shipment status.

Prerequisites

• Account on the DHL Developer Portal: https://developer.dhl.com

• Admin access in armin.cx to manage integrations

Steps

Part 1: Create an app in the DHL Developer Portal

1. Open the DHL Developer Portal at https://developer.dhl.com and sign in or register.

2. Open the Apps area (My Apps) from the profile icon in the top right.

3. Click + Create App.

4. Enter an App name (for example cx integration). A description is optional.

5. Under Select APIs, in the API's name field, choose Shipment Tracking - Unified. The environment shows as Production (Europe) with the default rate limit 250 requests every 1 day.

6. Click the red + in the Add to app column so the API appears in the Selected APIs list.

7. Click Create App at the bottom.

8. The app is created with status in progress. Open the app.

9. In the Credential section, click Show key next to API Key and copy the value. Do the same for API Secret.

Part 2: Connect the account in armin.cx

1. In armin.cx, click your profile in the bottom left and choose Integrations.

2. Select DHL in the integrations list and switch to the Accounts tab.

3. Click + Add account.

4. In the Add DHL Integration dialog:

   • Name: enter a display name, or pick the relevant shop if you run multiple shops.

   • API Key: paste the value from the DHL Developer Portal.

   • API Secret: paste the value from the DHL Developer Portal.

5. Click Connect. On success, the toast Integration connected successfully appears and the account is listed under Accounts connected.

Notes / best practices

• The Shipment Tracking - Unified API has to be approved by DHL. Right after creation, the app status is in progress and the API status is pending. Connecting to armin.cx is still possible; tracking calls only start working once DHL approves the API.

• Default rate limit: 250 requests every 1 day. An upgrade can be requested via Request Rate Limit Upgrade in the app detail view.

• Do not share the API Key or API Secret. New credentials can be generated via Add key in the app if needed.

• Multi-shop setups: add one account per shop and use the Name field to assign each account to the correct shop.

• Once connected, the DHL integration can be used in the Workflow Builder as a data source for tracking steps and WISMO flows.

FAQ

Which API has to be selected? Shipment Tracking - Unified.

What happens if the status stays on pending? While the API is not approved, DHL will not return tracking data. Approval usually takes a few business days. If approval takes longer, contact DHL directly.

Can I connect more than one DHL account? Yes. Add a separate account per shop or brand in armin.cx and pick the matching value in the Name field.