Register a shipment for tracking
trackingmore_create_trackingDestructive
WRITE: register ONE shipment so TrackingMore starts tracking it. This uses one credit of the account's plan (credits beyond the plan are billed by TrackingMore as overage): confirm with the user before creating, and never create trackings in bulk. Fails with 'Tracking No. already exists' if it is already registered. Needs the tracking number and the courier code (use trackingmore_detect_courier if unknown). Some couriers need extra fields (postal code, ship date, key). Returns the new tracking with its id. POST /trackings/create.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Free-text note. | |
| label | No | Label to group shipments. It must be a label you created in the TrackingMore dashboard first, otherwise TrackingMore refuses it (meta 4131). | |
| title | No | Short title for the shipment. | |
| language | No | Language code for status text, e.g. en. | |
| order_id | No | Your order id in the shop system. | |
| order_date | No | Order date, e.g. 2026-10-01T10:00:00+00:00. | |
| courier_code | Yes | TrackingMore courier code, e.g. usps, ups, dhl (see trackingmore_list_couriers / trackingmore_detect_courier). | |
| customer_sms | No | Recipient mobile number, with country code. | |
| order_number | No | Your order number for this shipment. | |
| tracking_key | No | Tracking key / phone suffix (needed by some couriers). | |
| customer_name | No | Recipient name. | |
| customer_email | No | Recipient email (TrackingMore can send delivery notifications to it when enabled in the account). | |
| tracking_number | Yes | The shipment's tracking number. | |
| logistics_channel | No | Logistics channel / service name. | |
| recipient_postcode | No | Recipient postcode. | |
| tracking_ship_date | No | Ship date, yyyymmdd (needed by some couriers). | |
| origin_country_iso2 | No | Origin country, ISO 3166 alpha-2. | |
| tracking_postal_code | No | Recipient postal code (needed by some couriers). | |
| tracking_origin_country | No | Origin country for couriers that need it, ISO 3166 alpha-2. | |
| destination_country_iso2 | No | Destination country, ISO 3166 alpha-2. | |
| tracking_courier_account | No | Courier account (needed by some couriers). | |
| tracking_destination_country | No | Destination country for couriers that need it, ISO 3166 alpha-2. |