How to Connect BlueDart to Apragya and Start Tracking Shipments
For dispatch managers and IT admins: the details to collect, the order to enter them, and the checks that prove bookings and tracking will work.
To connect BlueDart to Apragya you need three account details from Blue Dart, a registered pickup address and a shared secret for tracking callbacks. With those ready, the setup takes a short session.
The connector checks what it can before calling Blue Dart. A missing licence key or pickup location is reported plainly, instead of as a confusing rejection from the courier.
Below are the steps, an illustrative example from Ludhiana and the checks to run before you move all dispatches.
How to connect BlueDart to Apragya
Ask Blue Dart for API access on your account. You need the customer code, a licence key and a login ID, and your registered pickup address. Agree a webhook secret so tracking callbacks can be signed.
In Apragya, add a Blue Dart connection: put the customer code and pickup location in the settings, and the licence key, login ID and secret in the credentials. Run the test, then book a test parcel.
- Request API access from Blue Dart for your customer code.
- Note the licence key, login ID and pickup address.
- Add the Blue Dart connection in Apragya.
- Enter the webhook secret shared with Blue Dart.
- Run the test and book one test parcel.
An example: a Ludhiana hosiery exporter
Take an illustrative exporter that ships sample parcels to buyers across India by Blue Dart. The operations head set up the connection on a Friday and wanted to book the next Monday.
The connection details, as entered
Blue Dart connection
Every request is refused without it.
Issued by Blue Dart for API use.
Needed together with the licence key.
The registered collection address.
Used to verify tracking callbacks.
A known pincode returned as served.
On Monday the team booked eight sample parcels. Scans started arriving that afternoon, and the operations head read the first delivered status on the shipment record two days later.
Common reasons a courier setup stalls
Half the credentials
A licence key without the login ID, or the reverse.
No pickup address
Bookings are refused because nobody set the collection point.
No callback secret
Tracking callbacks are refused because they cannot be verified.
Untested pincodes
Orders are promised to places the courier does not serve.
How the Blue Dart licence key setup fits together
Step 1 of 5
Account detail
The customer code goes on the connection's settings.
- Account detail: The customer code goes on the connection's settings.
- Secrets: The licence key, login ID and webhook secret are stored encrypted.
- Test: The test checks a known pincode, which proves the credentials work.
- Booking checks: Booking stops early if a credential or pickup address is missing.
- Callbacks: Each tracking callback is verified against the secret before use.
Setting up the BlueDart tracking webhook
Tracking can come from callbacks or from a manual re-sync. Callbacks are better, because scans arrive as they happen. They are also the part that needs care: an unverified callback could mark any parcel delivered, so Apragya refuses callbacks it cannot verify.
Callback set-up, compared
| Feature | Without a secret | Apragya with a secret |
|---|---|---|
| Callbacks accepted | No, refused | Yes, when the signature matches |
| Scan timing | Only on manual re-sync | As the courier sends them |
| Fake delivered status | Not possible, refused | Not possible, verified |
| Raw courier text | Not received | Kept beside our status |
Checked against public information on 16 September 2026.
Before you move every dispatch
- Book a few test parcels to different regions.
- Confirm scans arrive on the shipment timeline.
- Try a cancellation on a test booking.
- Show support where to read the timeline.
If scans do not arrive, check the secret first, then use a manual re-sync on the shipment.
What you get once BlueDart API credentials are in
Shipments with AWB
Carrier, waybill, weight and freight on the shipment.
Status in one vocabulary
Blue Dart codes mapped to one set of statuses.
Scans in order
A late scan cannot overwrite a delivered status.
Linked documents
Delivery notes and packing slips on the same shipment.
Agents with review
An agent can flag parcels that have stopped moving.
Access by role
Dispatch and support see what they need.
Read the BlueDart integration overview and shipments.
What it costs to start
Connecting BlueDart, answered
Where do we get the licence key?
Why are our callbacks being refused?
Can we test without booking a parcel?
Can we connect more than one pickup address?
What does it cost to start?
Book Monday's parcels from Apragya
Gather the Blue Dart details, add the connection and run the pincode test.