n8n-nodes-ship24

Automate global shipment tracking inside n8n using the Ship24 API.

The Ship24 node enables production-grade shipment tracking workflows
including bulk tracker creation, structured result retrieval, multi-item
processing, and robust error handling.

---

About Ship24

Ship24 is a global shipment tracking API supporting 1500+ couriers and
marketplaces worldwide.

This node allows n8n users to:

• Create shipment trackers
• Retrieve tracking results
• Update tracker subscription status
• Process bulk shipments
• Automate delivery workflows at scale

---

Features

• Single tracker creation
• Bulk tracker creation (automatic chunking up to 100 per request)
• Create and immediately fetch tracking results
• Retrieve results by tracking number
• Retrieve results by tracker ID
• Update tracker subscription status
• Full n8n multi-item support
• Structured per-item error handling
• continueOnFail support
• Utility mode for advanced API access

---

Installation

Community Node Installation

1. Open n8n.
2. Go to Settings → Community Nodes.
3. Click Install.
4. Enter:

<!-- -->

n8n-nodes-ship24

5. Restart n8n if required.

---

Credentials Setup

This node requires a Ship24 API key.

1. In n8n, create new credentials.
2. Select Ship24 API.
3. Enter your API key.
4. Save.

---

Node Overview

The node provides two resources:

• Tracker
• Utility

---

Tracker Resource

Create

Create shipment trackers.

Supports:

• Single per item
• Bulk mode (up to 100 tracking numbers per API request)

Bulk Mode Behaviour

Bulk mode still follows standard n8n multi-item logic.

Each incoming item must contain one tracking number per item.
The Ship24 node automatically batches those items into API requests of
up to 100 tracking numbers per call.

Expected Input Format

Your previous node (Set, Code, HTTP Request, Google Sheets, etc.) should
output items like:

• Item 1 → { "trackingNumber": "00340435063770617839" }
• Item 2 → { "trackingNumber": "00340434788009688510" }
• Item 3 → { "trackingNumber": "00340434788009688268" }

If your upstream system provides an array of tracking numbers, use an
Item Lists, Split Out Items, or Code node to convert the array into
multiple items before passing them to the Ship24 node.

Automatic Chunking

If more than 100 items are provided, the node automatically splits them into multiple API calls.

Input items	API calls
80	1
150	2
250	3

Each input item returns exactly one output item.

---

Create and Get Results

Creates a tracker and immediately retrieves tracking results.

Useful when:

• You need tracking data immediately
• You want simplified output for automation workflows

---

Update

Update tracker subscription status (isSubscribed only).

• Requires a valid trackerId (UUID)
• Performs UUID validation before the API call

---

Get Results

Retrieve tracking data:

• By tracking number
• By tracker ID

---

Utility Resource

The Utility resource allows advanced API access.

You can:

• Define HTTP method
• Define path
• Provide custom request body
• Provide query parameters

---

Response Modes

Raw Mode

This node returns the full Ship24 API response (raw mode).

---

Multi-Item Behaviour

This node fully supports n8n multi-item processing:

• One output item per input item
• Bulk operations preserve input-to-output mapping
• No silent drops
• Large workflows (50+ items) supported

---

Error Handling

The node includes structured error handling for:

• 401 Unauthorized
• 404 Not Found
• 429 Rate limit
• Invalid UUID format
• Empty tracking number
• Bulk mapping failures

With continueOnFail enabled, per-item failures return structured
objects:

{
  "success": false,
  "error": {
    "type": "request_error",
    "message": "..."
  }
}

This allows resilient workflow design without unexpected crashes.

---

Performance Notes

• Bulk mode automatically chunks at 100 items per API request.
• Large workflows are processed sequentially per chunk.

---

Development

Build

npm run build

Lint

npm run lint

Local package test

npm pack

---

License

MIT