Shiprocket Node

Create orders, generate AWBs, request pickups, track shipments, manage returns, and check courier rates — all via Shiprocket's API. The essential node for any Indian D2C store automating its logistics pipeline.

Prerequisites

A Shiprocket account at shiprocket.in
Your Shiprocket login email and password (used for JWT authentication)
At least one pickup location (warehouse) set up in Shiprocket

Nodebase automatically manages JWT token renewal for every workflow execution. You only need to provide email and password once.

Credentials

Field	Description	Where to find it
Email	Your Shiprocket account email	The email you use to log in to shiprocket.in
Password	Your Shiprocket account password	The password you use to log in to shiprocket.in

Operations

Create Order

Create a new forward shipment order in Shiprocket. Returns an order ID, shipment ID, and AWB code.

Name	Type	Required	Default	Description
`orderId`	`string`	Yes	—	Your internal order ID, e.g. SHP-001 or Razorpay payment ID
`orderDate`	`string`	Yes	—	Date in YYYY-MM-DD HH:mm format
`pickupLocation`	`string`	Yes	—	Warehouse name exactly as set up in Shiprocket
`billingName`	`string`	Yes	—	Customer full name
`billingAddress`	`string`	Yes	—	Street address line 1
`billingCity`	`string`	Yes	—	City name
`billingState`	`string`	Yes	—	State name
`billingPincode`	`string`	Yes	—	6-digit PIN code
`billingEmail`	`string`	Yes	—	Customer email
`billingPhone`	`string`	Yes	—	Customer phone (10 digits)
`orderItems`	`JSON array`	Yes	—	[{"name":"T-Shirt","sku":"TS-M","units":1,"selling_price":499,"discount":0,"tax":0,"hsn":""}]
`paymentMethod`	`string`	Yes	—	"prepaid" or "cod"
`subTotal`	`number`	Yes	—	Order total in rupees (not paise)
`length`	`number`	Yes	—	Package length in cm
`breadth`	`number`	Yes	—	Package breadth in cm
`height`	`number`	Yes	—	Package height in cm
`weight`	`number`	Yes	—	Package weight in kg
`shippingIsBilling`	`boolean`	No	`true`	If false, separate shipping address fields appear
`codAmount`	`number`	No	—	COD amount in rupees — required if paymentMethod is cod
`channelId`	`string`	No	—	Shiprocket channel ID if using multi-channel setup

jsonOutput

{
  "shiprocket": {
    "order_id": 98765432,
    "shipment_id": 12345678,
    "status": "NEW",
    "awb_code": "1234567890123",
    "courier_name": "BlueDart"
  }
}

textExample — triggered by Razorpay payment

Razorpay Trigger (payment.captured)
→ Shiprocket — Create Order
    orderId:        {{razorpayTrigger.payload.payment.entity.id}}
    orderDate:      {{razorpayTrigger.receivedAt}}
    pickupLocation: Mumbai Warehouse
    billingName:    {{razorpayTrigger.payload.payment.entity.notes.name}}
    billingPhone:   {{razorpayTrigger.payload.payment.entity.contact}}
    billingEmail:   {{razorpayTrigger.payload.payment.entity.email}}
    billingPincode: {{razorpayTrigger.payload.payment.entity.notes.pincode}}
    billingCity:    {{razorpayTrigger.payload.payment.entity.notes.city}}
    billingState:   {{razorpayTrigger.payload.payment.entity.notes.state}}
    billingAddress: {{razorpayTrigger.payload.payment.entity.notes.address}}
    paymentMethod:  prepaid
    subTotal:       {{razorpayTrigger.payload.payment.entity.amount}}
    orderItems:     [{"name":"T-Shirt","sku":"TS-M","units":1,"selling_price":499}]
    length:         30
    breadth:        25
    height:         5
    weight:         0.5

Get Order

Fetch full details of a Shiprocket order by its ID.

Name	Type	Required	Default	Description
`shiprocketOrderId`	`string`	Yes	—	Shiprocket order ID — use {{shiprocket.order_id}}

Cancel Order

Cancel a Shiprocket order before pickup.

Name	Type	Required	Default	Description
`shiprocketOrderId`	`string`	Yes	—	Shiprocket order ID
`cancelReason`	`string`	Yes	—	Reason for cancellation

Generate AWB

Assign a courier and generate an AWB (Air Waybill) number for a shipment. Leave courier ID blank for auto-assignment.

Name	Type	Required	Default	Description
`shipmentId`	`string`	Yes	—	Shipment ID from Create Order — {{shiprocket.shipment_id}}
`courierId`	`string`	No	—	Leave blank for Shiprocket to auto-select best courier

jsonOutput

{
  "shiprocket": {
    "awb_code": "1234567890123",
    "courier_name": "Delhivery",
    "shipment_id": 12345678
  }
}

Generate Label

Generate a shipping label PDF for a shipment. Use the returned URL to download or email it.

Name	Type	Required	Default	Description
`shipmentId`	`string`	Yes	—	Shipment ID — {{shiprocket.shipment_id}}

jsonOutput

{
  "shiprocket": {
    "label_url": "https://shiprocket.co/labels/abc123.pdf"
  }
}

Request Pickup

Schedule a courier pickup for a shipment.

Name	Type	Required	Default	Description
`shipmentId`	`string`	Yes	—	Shipment ID — {{shiprocket.shipment_id}}

jsonOutput

{
  "shiprocket": {
    "pickup_scheduled_date": "2026-04-02",
    "status": "Pickup Scheduled"
  }
}

Track Shipment

Get live tracking status and activity history for a shipment using its AWB code.

Name	Type	Required	Default	Description
`awbCode`	`string`	Yes	—	AWB code — {{shiprocket.awb_code}}

jsonOutput

{
  "shiprocket": {
    "tracking_data": { "etd": "2026-04-04", "courier": "Delhivery" },
    "current_status": "In Transit",
    "shipment_track": [
      { "date": "2026-04-01 14:00", "activity": "Shipment picked up" },
      { "date": "2026-04-02 08:00", "activity": "In transit - Delhi Hub" }
    ]
  }
}

Get Order Tracking

Fetch tracking data using a Shiprocket order ID.

Name	Type	Required	Default	Description
`shiprocketOrderId`	`string`	Yes	—	Shiprocket order ID — {{shiprocket.order_id}}

Check Serviceability

Check if a delivery PIN code is serviceable from a pickup PIN code.

Name	Type	Required	Default	Description
`pickupPostcode`	`string`	Yes	—	Warehouse PIN code
`deliveryPostcode`	`string`	Yes	—	Customer PIN code

jsonOutput

{
  "shiprocket": {
    "serviceable": true,
    "data": {
      "available_courier_companies": [
        { "courier_name": "Delhivery", "rate": 45, "etd": "3 Days" }
      ]
    }
  }
}

Get Rate

Compare shipping rates and ETD across all available couriers for a shipment.

Name	Type	Required	Default	Description
`pickupPostcode`	`string`	Yes	—	Warehouse PIN code
`deliveryPostcode`	`string`	Yes	—	Customer PIN code
`weight`	`number`	Yes	—	Package weight in kg
`cod`	`boolean`	No	`false`	Set to true for COD shipments

Create Return

Create a return shipment for an existing order.

Name	Type	Required	Default	Description
`shiprocketOrderId`	`string`	Yes	—	Original Shiprocket order ID
`orderItems`	`JSON array`	Yes	—	Items being returned
`billingName`	`string`	Yes	—	Customer name
`billingPhone`	`string`	Yes	—	Customer phone
`billingAddress`	`string`	Yes	—	Pickup address for return
`billingPincode`	`string`	Yes	—	Customer PIN code

Get Pickup Locations

List all warehouse / pickup locations configured in your Shiprocket account.

jsonOutput

{
  "shiprocket": {
    "shipping_address": [
      { "pickup_location": "Mumbai Warehouse", "pin_code": "400001" }
    ]
  }
}

Complete Workflow Examples

Full Post-Payment Fulfilment Pipeline

Use case: After Razorpay payment, create order in Shiprocket, generate AWB, request pickup, and notify customer.

textWorkflow

Razorpay Trigger (payment.captured)
→ Shiprocket — Create Order
    orderId:      {{razorpayTrigger.payload.payment.entity.id}}
    billingPhone: {{razorpayTrigger.payload.payment.entity.contact}}
    paymentMethod: prepaid
    ...
→ Shiprocket — Generate AWB
    shipmentId: {{shiprocket.shipment_id}}
→ Shiprocket — Request Pickup
    shipmentId: {{shiprocket.shipment_id}}
→ WhatsApp — Send Message
    to:      {{razorpayTrigger.payload.payment.entity.contact}}
    message: "Order confirmed! Tracking ID: {{shiprocket.awb_code}}
              Expected delivery: 3-5 business days."

WhatsApp Tracking Bot

Use case: Customer sends an AWB number on WhatsApp and gets live tracking status.

textWorkflow

WhatsApp Trigger (messageTypes: text)
→ Shiprocket — Track Shipment
    awbCode: {{whatsappTrigger.text}}
→ WhatsApp — Send Message
    to:      {{whatsappTrigger.from}}
    message: "Status: {{shiprocket.current_status}}
              Last event: {{shiprocket.shipment_track[0].activity}}"

Common Issues & Solutions

Issue	Cause	Solution
Pickup location not found	Warehouse name typo or not set up	Use Get Pickup Locations to see exact warehouse names
AWB generation fails	No courier available for the PIN code	Use Check Serviceability first to verify coverage
Order creation fails with 422	Missing required fields or invalid dimensions	Ensure all required fields are filled — especially weight, dimensions, and pincode
Authentication error	Wrong email/password in credential	Re-enter credentials — Shiprocket uses JWT that Nodebase auto-renews

Razorpay Trigger — trigger fulfilment on payment captured
WhatsApp — send AWB code and delivery updates to customer
MSG91 — send SMS with tracking link
Gmail — email shipping label to warehouse staff

MSG91 Razorpay

Shiprocket Node

Prerequisites

Credentials

Operations

Create Order

Get Order

Cancel Order

Generate AWB

Generate Label

Request Pickup

Track Shipment

Get Order Tracking

Check Serviceability

Get Rate

Create Return

Get Pickup Locations

Complete Workflow Examples

Full Post-Payment Fulfilment Pipeline

WhatsApp Tracking Bot

Common Issues & Solutions

Related Nodes