Connect your courier account: where to get the keys and what to paste

Before you start

• You are the store owner, or your role has "Manage settings". Courier keys can't be entered while support is signed in as you.
• Open Settings → Shipping & delivery and scroll to Courier accounts.
• Fill the Pickup address at the top first — the place couriers collect from and send returns to. Most couriers need it on every booking.
• Have your courier account ready, KYC done and wallet recharged (for prepaid couriers).
• Passwords, tokens and keys are saved hidden. When you edit a card later, leave a hidden box empty to keep what is saved.

Shiprocket

1. 1

   1. Create an API user in Shiprocket

   Shiprocket → Settings → API → Add New API User

   Use an email that is different from your Shiprocket login. Tick the modules and save. Shiprocket emails you the API user's password.

2. 2

   2. Paste it in Slaby

   Slaby → Settings → Shipping & delivery → Shiprocket card

   Type the API user email and password. In "Pickup location", type the name of your Shiprocket pickup address exactly, or leave it empty for your primary one. Tap Save, then Test connection — your Shiprocket pickup addresses show up.

3. 3

   3. Switch on live tracking

   Shiprocket card → Live tracking updates

   Tap Create token and copy the token at once — it is shown only once. In Shiprocket → Settings → API → Webhooks, paste the Webhook URL and the token.

   The Webhook URL on the card is your store's own address — copy it from the card, never from someone else's store.

4. 4

   4. If something goes wrong

   Common causes:

   • "The courier rejected these login details": you typed your main Shiprocket login, not the API user. Use the API user email and its password.
   • Booking refused for a pickup location: the name must match Shiprocket's exactly. Leave it empty to use your primary address.
   • Booking refused for money: recharge your Shiprocket wallet.

Delhivery

1. 1

   1. Open a Delhivery account

   one.delhivery.com

   Sign up for free, finish KYC (GSTIN, or PAN and Aadhaar) and recharge your Delhivery wallet. Larger sellers with a Delhivery contract can use that account instead.

2. 2

   2. Add your pickup location

   Delhivery → Settings → Pickup Locations

   Add your warehouse or shop. Note its name exactly, with the same capital letters and spaces — Delhivery can't rename it later.

3. 3

   3. Get the API token

   Delhivery → Settings → API Setup → Request Live API Token

   Copy the token within 5 minutes. Requesting a new token stops the old one at once, so do it only when you change it here too. Enterprise accounts get the token from their Delhivery account manager.

4. 4

   4. Paste it in Slaby

   Slaby → Delhivery card

   Paste the API token and type the pickup location name. Choose Surface (cheaper) or Express, the time you want pickups, and Live. Tap Save, then Test connection.

5. 5

   5. Live tracking (optional)

   Delhivery card → Live tracking updates

   Delhivery switches on live updates on request. Tap Create token and email Delhivery support the Webhook URL, the header name x-slaby-token and the token, plus one or two of your tracking numbers. Until they set it up, Slaby asks Delhivery for tracking every few hours.

   The Webhook URL on the card is your store's own address — copy it from the card, never from someone else's store.

6. 6

   6. If something goes wrong

   • "ClientWarehouse matching query does not exist": the pickup location name doesn't match Delhivery's. Copy it again from Settings → Pickup Locations.
   • "The courier rejected these login details": the token was replaced in Delhivery, or it's a staging token with Live selected.
   • "Duplicate order id": that order was already booked in Delhivery. Look it up in your Delhivery panel.
   • Delhivery also owns Ecom Express now. If you shipped with Ecom Express, connect Delhivery.

Xpressbees

1. 1

   1. Open an Xpressbees account

   shipmentv2.xpressbees.com

   Sign up, finish KYC (PAN, GST, bank account) and recharge the wallet (₹200 minimum). Each booking takes money from the wallet; a cancel puts it back.

2. 2

   2. Add your warehouse

   Xpressbees → Settings → Warehouse

   Add your pickup address and note its name (up to 20 letters).

3. 3

   3. Paste it in Slaby

   Slaby → Xpressbees card

   Xpressbees uses your normal Xpressbees login for its API. Type that email and password and the warehouse name. Tap Save, then Test connection.

   If you change your Xpressbees password later, change it here too, or bookings stop.

4. 4

   4. Switch on live tracking

   Xpressbees → Services → Webhooks

   In Slaby, tap Create token and copy it. In Xpressbees, add a webhook: paste the Webhook URL from the card, paste the token as the secret, and set it Active.

   The Webhook URL on the card is your store's own address — copy it from the card, never from someone else's store.

5. 5

   5. If something goes wrong

   • "The courier rejected these login details": the email or password changed in Xpressbees.
   • Booking refused: check the wallet balance, the warehouse name, and that the buyer's phone has 10 digits.
   • Live updates stopped: Xpressbees switches a webhook off after many failed tries. Open Services → Webhooks and set it Active again.

Ekart

1. 1

   1. Open an Ekart Elite account

   app.elite.ekartlogistics.in

   Sign up (a proprietor without GST can join), wait for KYC (1–2 working days) and recharge at least ₹500 in the wallet.

2. 2

   2. Find your Client ID

   Ekart → Settings → API Settings → API Documentation

   Tap the eye icon to see the Client ID. The username and password are your Ekart login.

3. 3

   3. Paste it in Slaby

   Slaby → Ekart card

   Type the Client ID, username and password. Choose Surface or Express. If you have more than one pickup address in Ekart, type the name of the one to use; otherwise leave it empty. Add your GSTIN if you have one. Tap Save, then Test connection.

4. 4

   4. Tracking

   Slaby asks Ekart for tracking every few hours, and "Refresh tracking" asks right away. Buyers get Ekart's tracking link.

5. 5

   5. If something goes wrong

   • "The courier rejected these login details": check the Client ID (from the eye icon) and your Ekart password.
   • Cash on delivery above ₹49,999 can't be sent with Ekart.
   • Booking refused for an address: if you typed a pickup address name, it must match the name in Ekart.

Shadowfax

1. 1

   1. Get API access

   SFX 360 partner portal (shadowfax360.in) or your Shadowfax account manager

   Ask for API access to your Shadowfax client account and set your pickup slots with Shadowfax. Copy the Live API token (a staging token works with "Test (staging)").

2. 2

   2. Paste it in Slaby

   Slaby → Shadowfax card

   Paste the token, choose Live, tap Save, then Test connection.

3. 3

   3. Switch on live tracking

   SFX portal → Webhook tab, or email your account manager

   Tap Create token. Add the Webhook URL, a header named x-slaby-token with the token as its value, and ask Shadowfax to send awb_number, status_id and last_updated.

   The Webhook URL on the card is your store's own address — copy it from the card, never from someone else's store.

4. 4

   4. If something goes wrong

   • Labels work only before the parcel is picked up.
   • Orders of ₹50,000 or more need an e-way bill, which Slaby can't send yet — book those in the Shadowfax portal.

DTDC

1. 1

   1. Ask DTDC for API access

   DTDC sales or integration team

   They give a test (demo) key first, then a live key, plus your customer code. Ask which service types your account has, like B2C PRIORITY, and for the separate tracking username and password.

2. 2

   2. Paste it in Slaby

   Slaby → DTDC card

   Paste the API key, customer code and service type exactly as DTDC wrote it, and the tracking username and password. Tap Save, then Test connection.

3. 3

   3. Tracking

   DTDC doesn't send live updates. Slaby asks DTDC every few hours — only if you saved the tracking login.

4. 4

   4. If something goes wrong

   • "The courier rejected these login details": the API key is wrong, or it's a demo key with Live selected.
   • Booking refused for the service type: type it exactly as DTDC gave it.
   • No pickup or manifest from Slaby: DTDC picks up as agreed with your account.

Blue Dart

1. 1

   1. Check the card is there

   Blue Dart shows in Settings → Shipping only once Slaby has switched it on. If you don't see the card yet, ship Blue Dart through Shiprocket for now.

2. 2

   2. Get a Blue Dart business account

   Blue Dart sales / your account manager

   Ask for an account with e-commerce (eTail) and cash on delivery. Blue Dart gives you a login ID, a licence key, a customer code (and sometimes a separate one for COD), your area code (3 letters) and often a separate tracking licence key.

3. 3

   3. Create the API app

   Blue Dart's API portal

   Register, create an app and copy its client ID and client secret. Ask Blue Dart for sandbox keys first and test with "Test (sandbox)", then switch to live keys.

4. 4

   4. Paste it in Slaby

   Slaby → Blue Dart card

   Fill every box, choose Air or Surface and your pickup time, tap Save, then Test connection.

5. 5

   5. Good to know

   • Labels: Blue Dart gives the label only once, while booking, and Slaby can't print it yet. Print it from Blue Dart's own tools.
   • Tracking: Slaby asks Blue Dart every few hours.
   • If live keys fail but sandbox keys work, ask Blue Dart whether your keys are limited to certain server addresses.

Borzo (same day)

1. 1

   1. Copy the API token

   Borzo business account → API

   Borzo turns on live tokens for your account; a test token works with Test.

2. 2

   2. Paste it in Slaby

   Slaby → Borzo card

   Paste the token, add the pickup address and phone for riders, tap Save, then Test connection.

3. 3

   3. Switch on live tracking

   Borzo → API settings → callbacks

   Copy Borzo's callback secret into "Callback secret" in Slaby, and paste the Webhook URL from the card into Borzo's callback URL.

   The Webhook URL on the card is your store's own address — copy it from the card, never from someone else's store.

Ecom Express

Ecom Express is now part of Delhivery, and its old API has stopped working for most sellers. The Ecom Express card shows only if Slaby has switched it on for a seller whose old login still works.

If you used Ecom Express, connect Delhivery instead.

India Post, Shree Maruti and other couriers

India Post and Shree Maruti have no booking connection a store can use (India Post's is only for contract customers on approved servers). Book at the post office or courier counter, then add the tracking number by hand.

On the order, tap "New shipment", type the Courier name and Tracking no., and paste a Tracking link so the buyer can tap it:

• India Post: https://www.indiapost.gov.in (the buyer types the article number, like EE123456789IN, in "Track your shipment").
• Shree Maruti: https://shreemaruti.com/track-shipment/?awb= followed by the tracking number.
• Mark the parcel Dispatched, Out for delivery and Delivered yourself as it moves.

Messages every courier card can show

हिन्दी में

शुरू करने से पहले: Settings → Shipping & delivery → Courier accounts में सबसे ऊपर पिकअप पता भरें। हर कूरियर कार्ड में कुंजियाँ भरें, Save दबाएँ, फिर Test connection। छिपे बॉक्स बाद में खाली छोड़ें तो सेव की हुई कुंजी बनी रहती है।

Shiprocket: Settings → API → Add New API User (लॉगिन से अलग ईमेल), ईमेल-पासवर्ड यहाँ भरें; लाइव ट्रैकिंग के लिए Create token दबाकर URL और टोकन Shiprocket → Settings → API → Webhooks में डालें। Delhivery: one.delhivery.com पर अकाउंट, Settings → Pickup Locations में गोदाम (नाम हूबहू), Settings → API Setup से टोकन (5 मिनट में कॉपी करें; नया टोकन पुराना बंद कर देता है); लाइव ट्रैकिंग Delhivery सपोर्ट को ईमेल करके। Xpressbees: shipmentv2.xpressbees.com पर अकाउंट, Settings → Warehouse में गोदाम; अपना लॉगिन ईमेल-पासवर्ड और गोदाम का नाम भरें; Services → Webhooks में URL और टोकन (secret) डालें। Ekart: app.elite.ekartlogistics.in पर अकाउंट, Settings → API Settings → API Documentation में आँख वाले आइकन से Client ID; Client ID, यूज़रनेम, पासवर्ड भरें।

Shadowfax: SFX 360 पोर्टल या अकाउंट मैनेजर से API टोकन; Webhook टैब में URL और x-slaby-token हेडर। DTDC: सेल्स टीम से API key, कस्टमर कोड, सर्विस टाइप और ट्रैकिंग लॉगिन। Blue Dart: बिज़नेस अकाउंट से लॉगिन ID, लाइसेंस की, कस्टमर कोड, एरिया कोड, और API पोर्टल से client ID/secret; लेबल Blue Dart के अपने टूल से प्रिंट करें। India Post और Shree Maruti: काउंटर पर बुक करें, फिर ऑर्डर पर New shipment में कूरियर, ट्रैकिंग नंबर और ट्रैकिंग लिंक ख़ुद डालें।

Read next

• Shipping with SlabyShiprocket or a direct courier: how to choose.
• Daily shippingBook, labels, pickup and failed deliveries, day to day.