Create warehouse

POST

https://api.gotreek.com/api/warehouses

Warehouses

Last modified:2026-07-16 11:22:41

Create a new warehouse for the authenticated user by providing complete address, sender, and location details.

💡

Authentification

Bearer token authentication is required.

💡

short_address: Mandatory.
Must follow this format: 4 letters followed by 4 numbers.

💡

Validation Rules

city_id must exist in the cities table.

Email must be in a valid format.

All required address and sender fields must be provided.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://app.gotreek.com/api/auth/login

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Warehouse created successfully

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.gotreek.com/api/warehouses' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "warehouseApiDog",
    "code": "1",
    "city_id": 7,
    "district": "Al-Rawdah",
    "street_name": "Prince Sultan Street",
    "building_no_name": "test",
    "address": "Abu Arish",
    "short_address": "RRRR2424",
    "zip_code": "48288",
    "sender_name": "ApiDog",
    "sender_email": "test@example.com",
    "sender_phone": "+966533113333",
    "status": 1
}'

Response Example

201 - Success

{
    "success": true,
    "message": "Warehouse created successfully",
    "data": {
        "name": "warehouse1",
        "code": "1",
        "user_id": 1,
        "city_id": 7,
        "address": "Abu Arish",
        "short_address": "RRRR2424",
        "sender_name": "ApiDog",
        "sender_email": "test@example.com",
        "sender_phone": "+966555555555",
        "status": 1,
        "district": "Al-Rawdah",
        "street_name": "Prince Sultan Street",
        "building_no_name": "test",
        "zip_code": "48288",
        "latitude": null,
        "longitude": null,
        "updated_at": "2026-07-16T11:19:31.000000Z",
        "created_at": "2026-07-16T11:19:31.000000Z",
        "id": 2349,
        "location": {
            "lat": 0,
            "lng": 0
        },
        "city": {
            "id": 7,
            "name": "Abha Manhal",
            "name_ar": "ابها المنهل",
            "country_id": 1
        },
        "user": {
            "id": 1,
            "first_name": "test",
            "last_name": "test",
            "email": "test@example.com"
        }
    }
}

Modified at 2026-07-16 11:22:41

Warehouses List

warehouse Details