What parameters does POST /V1/shipment/track accept?

This endpoint accepts 1 parameter: entity (Magento\Sales\Api\Data\ShipmentTrackInterface) required.

What does POST /V1/shipment/track return?

The endpoint returns Magento\Sales\Api\Data\ShipmentTrackInterface.

POSTSales · Magento 2.4.9 Admin · Magento_Sales::shipment

POST /V1/shipment/track

Q: What does the POST /V1/shipment/track endpoint do in Magento 2?

POST /V1/shipment/track is a Magento 2 REST endpoint in the Sales module. Performs persist operations for a specified shipment track. Requires an admin Bearer token with ACL Magento_Sales::shipment.

Q: Does POST /V1/shipment/track require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Sales::shipment.

POST /V1/shipment/track is a Magento 2 REST endpoint in the Sales module. Performs persist operations for a specified shipment track. Requires an admin Bearer token with ACL Magento_Sales::shipment.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

Magento\Sales\Api\Data\ShipmentTrackInterface

Shipment track interface.

Service contract

Magento\Sales\Api\ShipmentTrackRepositoryInterface::save

Authorization

Admin Bearer token with ACL:

Magento_Sales::shipment

Body parameters

entity Magento\Sales\Api\Data\ShipmentTrackInterface Required

The shipment track.

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> admin token with ACL: Magento_Sales::shipment

Path

/V1/shipment/track

Body

{
  "entity": {
    "carrier_code": "",
    "created_at": "",
    "description": "",
    "entity_id": 0,
    "extension_attributes": {},
    "order_id": 0,
    "parent_id": 0,
    "qty": 0,
    "title": "",
    "track_number": "",
    "updated_at": "",
    "weight": 0
  }
}