Create Package

POST

https://api.gotreek.com/api/packages

Boxes

Last modified:2026-08-11 08:43:00

💡

Authentification

Bearer token authentication is required.

The package is always created for the currently authenticated user (user_id is taken from the token).

📌

Automatic fields

user_id: Automatically filled from the authenticated user and cannot be overridden.

weight: Defaults to 0 if not provided in the request.

💡

Behavior

Validates required fields (type, length, width, height, weight) before creation.

Persists the box with its full dimensions so it can be selected later in shipment flows.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Box created successfully

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.gotreek.com/api/packages' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "type": "primary",
    "length": 22,
    "width": 15,
    "height": 36,
    "weight": 3
}'

Response Example

201 - Success

{
    "success": true,
    "message": "Package created successfully",
    "data": {
        "type": "Medium Box",
        "length": 34051671,
        "width": 1213654,
        "height": 29116213,
        "weight": 22469655,
        "organisation_id": 21,
        "updated_at": "2026-08-11T08:45:26.000000Z",
        "created_at": "2026-08-11T08:45:26.000000Z",
        "id": 407
    }
}

Modified at 2026-08-11 08:43:00

Get Pickup id

Get Packages