How to Connect Delhivery to Apragya: Token, Pickup and First Booking
For e-commerce and dispatch teams: what to collect from Delhivery, where it goes, and how to prove booking, labels and tracking work before the busy season.
To connect Delhivery to Apragya you need an API token, the client name registered with Delhivery, a registered pickup location and a webhook secret. Delhivery's API authenticates with the token on every call.
The client name matters more than it looks. It identifies the pickup account, and a booking without it is rejected by the courier with an unhelpful message, so Apragya checks it first.
Below are the steps, an illustrative example from Jaipur and a short list of first-week checks.
How to connect Delhivery to Apragya
Get the API token and the registered client name from Delhivery, and confirm your pickup location is registered with them. Agree a webhook secret for tracking callbacks.
In Apragya, add a Delhivery connection with the client name and pickup location as settings, and the token and secret as credentials. Run the test, then book, label and cancel a test parcel before going live.
- Collect the API token and client name from Delhivery.
- Confirm the pickup location is registered.
- Add the Delhivery connection in Apragya.
- Enter the webhook secret agreed with Delhivery.
- Test, then book, label and cancel one parcel.
What slows a Delhivery setup down
Wrong token
A token from a test account used on the live account.
Client name mismatch
The name differs from the one Delhivery registered.
Pickup not registered
Bookings for an address the courier does not collect from.
Unsigned callbacks
Scans refused because no secret was shared.
An example: a Jaipur block-print apparel brand
Take an illustrative D2C brand preparing for the festive season. The founder wanted labels printing from the packing table and tracking visible to support before orders peaked.
Five days from token to festive-ready
Day 1
API token and client name received from Delhivery.Day 2
Connection added with the pickup location.Day 3
Test passed; pincodes and rates checked.Day 4
Ten test bookings with labels and a pickup.Day 5
Signed scans arriving on the timelines.
By the first festive weekend, packing staff printed labels at the table, the afternoon pickup was scheduled from the dispatch, and support read scan history on the shipment without opening the courier panel.
How the Delhivery API token and settings are used
Step 1 of 5
Token
The API token is stored encrypted and sent on every call.
- Token: The API token is stored encrypted and sent on every call.
- Client name and pickup: Saved on the connection and checked before each booking.
- Test: A light read proves the token works without booking anything.
- Labels and pickups: Fetch labels and schedule pickups for booked shipments.
- Callbacks: Scans are accepted only when their signature matches the secret.
Delhivery client name setup and webhooks, compared
The setup has two halves. The outbound half, token and client name, lets you book. The inbound half, the webhook secret, lets scans arrive on their own. Skipping the second half leaves you with manual re-syncs.
Half set up, against fully set up
| Feature | Token only | Apragya fully set up |
|---|---|---|
| Booking | Works if client name is right | Checked before each call |
| Labels and pickup | Works | Works |
| Scans | Manual re-sync only | Arrive on signed callbacks |
| Support view | Stale until re-synced | Current timeline |
Checked against public information on 16 September 2026.
Why the Delhivery webhook setup is worth finishing
Current status
Scans arrive as the courier sends them.
Correct order
A late scan cannot undo a delivered status.
Disputes settled
The courier's own text is kept beside our status.
One shipment record
Order, delivery note and label linked.
Agents with review
Stuck parcels can be flagged for a person.
More couriers
Blue Dart and Shiprocket follow the same pattern.
Read the Delhivery integration overview and pick lists.
First-week checks
- Book parcels to metro and remote pincodes.
- Print labels from the packing table.
- Schedule and confirm one pickup.
- Cancel one test booking.
- Confirm scans arrive without a manual re-sync.
Run these a week before your busy season, not during it.
What it costs to start
Connecting Delhivery, answered
Where is the API token?
What exactly is the client name?
Does the test book a parcel?
Why are scans not arriving?
What does it cost to start?
Be festive-ready a week early
Add the Delhivery connection, book ten test parcels and watch the scans arrive.