Multi Label Printing By Webhook

This API allows clients to generate shipping labels for one or multiple parcels in a single request.
Clients can send one or more HAWB numbers (comma-separated), and the API will return a unique downloadable PDF label URL for each HAWB provided.
This endpoint is designed for bulk label generation through webhook-based integrations, enabling external courier systems, eCommerce platforms, and logistics partners to instantly fetch label files required for dispatch.
Key Features
Generate single or multiple labels in one request
Supports comma-separated HAWB numbers
Returns individual PDF URLs for each HAWB
Ideal for automated order processing and bulk shipment workflows

Typical Use Cases
Automatically generate labels when an order is created in a third-party system
Bulk label printing during warehouse packing operations
Integrations for eCommerce, ERP, or courier aggregators needing instant label files
Webhook-based automated parcel creation and label generation

Request Requirements
Each request must include:
X-WebHook-Secret header (shared secret token provided by HeyCouriers)
JSON body containing the hawb field (single or multiple comma-separated values)

Response
The API returns a list of labels, where each entry contains:
The provided HAWB number
A download URL for that parcel’s PDF label

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
  "success": true,
  "labels": [
    {
      "hawb": "EZShipTest1001",
      "url": "https://heycouriers-dev-files.s3.ap-south-1.amazonaws.com/package_labels/23694_20251117163535_EZShipTest1001.pdf"
    },
    {
      "hawb": "EZShipTest1002",
      "url": "https://heycouriers-dev-files.s3.ap-south-1.amazonaws.com/package_labels/23695_20251117163536_EZShipTest1002.pdf"
    }
  ]
}