Quick Start

Get from sign-up to your first tracked shipment in under 10 minutes.

This guide explains how to import your first shipment into Track123 and start tracking in minutes.

At the end of this guide, you'll have shipments live in your dashboard, ready to monitor and customize.

1

Create your account

Go to track123.com and register for a free account. No credit card required for the Starter plan.

After creating your account, you'll land on the Home page where your onboarding checklist is ready to guide you through the next steps.

2

Get your API token

Your API token is displayed on the Home page under the For developer panel.

Keep your API token secure. Do not expose it in client-side code or public repositories. If compromised, click Reset on the Home page to generate a new one immediately.

3

Import your shipments

There are four ways to import shipments into Track123. Choose the one that fits your workflow.

Via API

For developers and automated workflows. Your system sends tracking numbers to Track123 programmatically as orders are fulfilled.

1. Copy your API token from the Home page
2. Send a POST request to create a shipment

curl --request POST \
     --url https://api.track123.com/gateway/open-api/tk/v2.1/track/import \
     --header 'Track123-Api-Secret: 952a057cafde432xxxxe594e464de0ac' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
[
  {
    "trackNo": "LV209031969CN"
  }
]
'

1. The shipment will appear in your Shipment list immediately

→ Full API Reference

Via CSV

For bulk imports. Upload up to 50,000 shipments at once using a spreadsheet file.

1. Go to Shipment in the left navigation
2. Click Import → Via CSV
3. Click Download template to get the correct file format
4. Fill in your tracking numbers in the template — one row per shipment
5. Save the file and upload it
6. Track123 will process the file and import all valid rows

Rows with missing tracking numbers or invalid formatting will be skipped. An error report is shown after upload.

→ Import via CSV — full guide

Manually add shipments online

For quick one-off additions. Add up to 100 tracking numbers at once directly from the dashboard. No file or code required.

1. Go to Shipment in the left navigation
2. Click Add shipment in the top-right corner
3. Select the carrier from the dropdown
4. Enter your tracking numbers in the text box, one per line (up to 100)
5. Click Confirm

The shipments will appear in your list immediately with Pending status.

Via Store connection

For automatic imports. Connect your store and Track123 will sync shipments automatically as orders are fulfilled. Supported platforms.

Shoplazza, BigCommerce, Shopline.

1. Go to Store in the left navigation
2. Click Add store
3. Select your platform
4. Follow the on-screen instructions to authorize the connection
5. Once connected, new fulfilled orders will be imported into Track123 automatically

→ Connect a Store — full guide

4

Get your tracking results

There are three ways to get tracking results from Track123. Choose the one that fits your workflow.

Via API

For developers. Query tracking results programmatically by calling the GET endpoint.

curl --request POST \
     --url https://api.track123.com/gateway/open-api/tk/v2.1/track/query \
     --header 'Track123-Api-Secret: 952a057cafdexxxxxxxx594e464de0ac' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "trackNoInfos": [
    {
      "trackNo": "92612903033646543475000000"
    }
  ]
}
'

The response includes the current status, all checkpoints, carrier information, and timestamps.

→ Full API Reference

Via Webhook

For developers. Instead of querying the API manually, set up a Webhook to receive tracking updates pushed to your server automatically the moment a shipment status changes.

1. Go to Developer → Webhook in the left navigation
2. Click Add Webhook
3. Enter your endpoint URL and select the events you want to receive
4. Click Save

Track123 will send a POST request to your endpoint every time a tracked shipment changes status.

→ Set up Webhook — full guide

Check the Shipment dashboard

For non-developers. View and monitor all shipments directly from the dashboard. No coding required.

1. Go to Shipment in the left navigation
2. Browse shipments by status using the tabs at the top
3. Click any shipment to view the full tracking timeline and checkpoint details

That's it — your shipments are now being tracked. If you run into any issues or have questions, reach out to us via live chat anytime.