Carrier Connections

By default, Track123 retrieves tracking data through its own shared carrier channels. Carrier Connections let you link your own carrier accounts directly to Track123, so tracking data is pulled from your account instead.

Why use Carrier Connections

	Shared channel (default)	Your carrier account
Setup required	None	Yes — link your account
Data freshness	Standard	Higher — direct from your account
Tracking accuracy	Standard	Higher for your own shipments
Best for	General use	High-volume or enterprise operations

If no Carrier Connection is specified in an API request, Track123 automatically falls back to its shared channel.

Add a Carrier Connection

1. Go to Developer → Carrier connections in the left navigation
2. Click Add connection
3. Select the carrier you want to connect
4. Enter your carrier account credentials (API key, account number, or other required fields depending on the carrier)
5. Click Save

Once saved, the connection is assigned a unique Connection ID.

Using a Connection ID in API requests

When creating a shipment via API, pass the connectionId parameter to route tracking through your carrier account:

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

If connectionId is omitted, Track123 uses its shared channel as the fallback.

Using a Connection ID in bulk imports

When importing via CSV, add a connectionId column to your template and fill in the Connection ID for the relevant rows.

Managing connections

From the Carrier connections page you can:

• View all active connections and their assigned Connection IDs
• Edit credentials if your carrier account details change
• Delete a connection that is no longer needed

Deleting a connection does not affect shipments already tracked through it. New shipments using that connectionId will fall back to Track123's shared channel.