The Delivery Group (NEW)

The Delivery Group offers domestic and international services for shipments originating in the UK.

This guide provides developers with the details needed to build The Delivery Group (NEW) shipping capabilities into your ShipStation V2 API workflows.

When creating labels with The Delivery Group, you must include the following information in your shipment request:

Service Selection:

• service_code - The Delivery Group service code (see Service Details section)

Package Information:

• weight.value and weight.unit - Package weight in grams (whole numbers only)
• dimensions.length, dimensions.width, dimensions.height - Package dimensions in millimeters
• dimensions.unit - Must be set to millimeters

Recipient Address (ship_to object):

• name - Recipient name (required)
• address_line1 - Street address (required)
• city_locality - Town or city (required)
• postal_code - Postal code (required)
• country_code - ISO 2-letter country code (required)

Reference Information:

• Include at least one reference identifier for tracking purposes (e.g., order number, customer reference)

Contact Information:

• ship_to.email - Recipient email address (optional)
• ship_to.phone - Recipient phone number (optional)

Notification Preferences:

• Email and SMS notifications are enabled by default unless explicitly declined

The table below maps The Delivery Group's DocketHUB API fields to ShipStation V2 API equivalents for developers integrating directly.

You can connect a The Delivery Group account using the POST method to the /v2/connections/carriers/ endpoint, or via the ShipStation dashboard.

Log in to your ShipStation account and navigate to the Carriers section to connect your The Delivery Group account using your credentials.

carrier_code: the_delivery_group

POST /v2/connections/carriers/:carrier_code

curl -i -X POST \
  https://api.shipstation.com/v2/connections/carriers/dhl_express \
  -H 'Content-Type: application/json' \
  -H 'api-key: YOUR_API_KEY_HERE' \
  -d '{
    "nickname": "Stamps.com",
    "username": "your_username",
    "password": "your_password"
  }'

A successful connection will return a response with the carrier_id, which you'll use for any requests for this account going forward.

The Delivery Group does not currently support rate shopping with ShipStation V2 API. Your account contact can provide you with details about your contracted rates.

Services available with The Delivery Group are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.

The Delivery Group offers international shipping through the following service:

When shipping to international destinations, you must include item-level customs information in your shipment request.

Required Product Information (packages.products array):

• description - Item description (required)
• quantity - Item quantity (required)
• value.amount - Total item value OR unit value (required)
• value.currency - Currency code (required; e.g., "GBP")
• country_of_origin - Item country of origin (required; two-letter country code)
• harmonized_tariff_code - HS code for customs classification (required; e.g., 42023100)

Additional Customs Fields:

• customs.contents - Set to "documents" for documents-only shipments, or "merchandise" for goods
• customs.contents_explanation - Reason for export (required when customs.contents is "other")
• customs.invoice_additional_details.freight_charge - Freight charge as a monetary_value object for customs declaration

Tax Identifiers (tax_identifiers array, if applicable):

Depending on your destination, you may need to include:

• EORI Number - For shipments to/from EU countries

  • taxable_entity_type: "shipper" or "recipient"
  • identifier_type: "eori"
  • value: Your EORI number
  • issuing_authority: Country code (e.g., "GB")

• IOSS Number - For B2C shipments to EU with value ≤ €150

  • taxable_entity_type: "shipper"
  • identifier_type: "ioss"
  • value: Your IOSS number
  • issuing_authority: Country code (e.g., "GB")

See the International Shipments guide for complete details on customs declarations and tax identifiers.

For shipments from Great Britain to Northern Ireland under the Windsor Framework, you must include the same item-level customs information required for international shipments (see International Services section above).

UK IMS Tax Identifier:

For GB to Northern Ireland shipments, include your UK Internal Market Scheme number in the tax_identifiers array:

• UK IMS Number
  • taxable_entity_type: "shipper"
  • identifier_type: "ukims"
  • value: Your UK Internal Market Scheme number
  • issuing_authority: "XI"

See the Windsor Framework guide for complete details on Northern Ireland shipping requirements.

The Delivery Group does not currently support creating return labels.

The following carrier package types are available for The Delivery Group services:

The Delivery Group does not support adding carrier insurance to shipments created with ShipStation V2 API.

• Label sizes: 4" x 6"
• Label formats: PDF, PNG, ZPL
• Supports unicode characters: yes, for CN22 labels only

The Delivery Group supports adding custom label messages for the following services only:

• Domestic: Utrak No Tracking, Utrak
• International: Etrak, Etrak Lite, International Untracked

The Delivery Group does not support creating multi-package shipments.

The Delivery Group does not support creating branded labels.

The Delivery Group does not support voiding labels with ShipStation V2 API.

The Delivery Group does not support paperless labels.

Customs declarations print directly on the labels for international shipments.

See our Delivery Confirmation page for more details about using the confirmation property.

The Delivery Group supports certain advanced options, which you can add to the shipment object when creating a shipment or label.

To ensure you always have the most up-to-date information about a carrier's advanced options, use the list carrier options endpoint.

The Delivery Group does not require manifesting your shipments.

The Delivery Group does not support scheduling pickups using ShipStation V2 API.

The Delivery Group does not support shipping to service points.

ShipStation V2 API's integration with The Delivery Group supports receiving tracking updates. Review our ​Track Shipments guide​​ for details on tracking with the ShipStation V2 API.

To disconnect your The Delivery Group account, use the DELETE method on the carrier connection endpoint.

Here are tips on how to handle common issues when shipping with The Delivery Group.