Create Shipment
Production
https://api.salla.dev/admin/v2
Production
https://api.salla.dev/admin/v2
POST
https://api.salla.dev/admin/v2
Last modified:2025-07-07 08:04:13
ship_to#
country_id → use the ship_to.country variablecity_id → use the ship_to.city variableship_from#
country_id → use the ship_from.country variablecountry_code → use the ship_from.country variablecity_id → use the ship_from.city variableScopes
shipping.read_write- Shipping Read & WriteRequest
Authorization
Add the parameter
Authorization
to Headers，whose value is to concatenate the Token after the Bearer.Example:
Authorization: Bearer ********************Body Params application/json
Example
{
"overwrite_exists_pending": true,
"courier_id": 1927161457,
"order_id": 54534523,
"shipment_type": "shipment",
"payment_method": "pre_paid",
"cash_on_delivery": {
"amount": 10.7,
"currency": "SAR"
},
"description": "Fashion Apparel - 3 T-Shirts",
"remarks": "Customer requested delivery after 5 PM",
"external_id": "34567898",
"external_additional_id": "OM656545543",
"external_company_name": "Salla Express",
"service_types": [
"international",
"normal",
"fulfillment"
],
"policy_options": {
"boxes": 1
},
"ship_to": {
"name": "Mohammed Khalid",
"email": "test@gmail.com",
"phone": "966501636784",
"country": 1473353380,
"city": 1473353380,
"postal_code": "95128",
"street_number": "2345",
"block": "السلام",
"address_line": "شارع عبدالله سنابل السلام مكة السعوديه",
"geo_coordinates": {
"lat": 21.3825905096851,
"lng": 39.77319103068542
}
},
"ship_from": {
"type": "address",
"name": "الفرع الرئيسي",
"email": "",
"phone": "966501636784",
"country": 1473353380,
"city": 1939592358,
"address_line": "Mecca,السعودية",
"street_number": "1234",
"block": "block",
"postal_code": "1234",
"geo_coordinates": {
"latitude": [
21.3825905096851
],
"longitude": [
39.77319103068542
]
}
},
"packages": [
{
"external_id": null,
"name": "منتج تجريبي",
"sku": "52743-145",
"quantity": 1,
"price": {
"amount": 25.5,
"currency": "SAR"
},
"weight": {
"value": 5,
"units": "kg"
}
}
]
}Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.salla.dev/admin/v2/shipments' \
--header 'Content-Type: application/json' \
--data-raw '{
"overwrite_exists_pending": true,
"courier_id": 1927161457,
"order_id": 54534523,
"shipment_type": "shipment",
"payment_method": "pre_paid",
"cash_on_delivery": {
"amount": 10.7,
"currency": "SAR"
},
"description": "Fashion Apparel - 3 T-Shirts",
"remarks": "Customer requested delivery after 5 PM",
"external_id": "34567898",
"external_additional_id": "OM656545543",
"external_company_name": "Salla Express",
"service_types": [
"international",
"normal",
"fulfillment"
],
"policy_options": {
"boxes": 1
},
"ship_to": {
"name": "Mohammed Khalid",
"email": "test@gmail.com",
"phone": "966501636784",
"country": 1473353380,
"city": 1473353380,
"postal_code": "95128",
"street_number": "2345",
"block": "السلام",
"address_line": "شارع عبدالله سنابل السلام مكة السعوديه",
"geo_coordinates": {
"lat": 21.3825905096851,
"lng": 39.77319103068542
}
},
"ship_from": {
"type": "address",
"name": "الفرع الرئيسي",
"email": "",
"phone": "966501636784",
"country": 1473353380,
"city": 1939592358,
"address_line": "Mecca,السعودية",
"street_number": "1234",
"block": "block",
"postal_code": "1234",
"geo_coordinates": {
"latitude": [
21.3825905096851
],
"longitude": [
39.77319103068542
]
}
},
"packages": [
{
"external_id": null,
"name": "منتج تجريبي",
"sku": "52743-145",
"quantity": 1,
"price": {
"amount": 25.5,
"currency": "SAR"
},
"weight": {
"value": 5,
"units": "kg"
}
}
]
}'Responses
🟢200Success
application/json
Body
Example
{
"status": 200,
"success": true,
"data": {
"id": 362985662,
"order_id": 560695738,
"order_reference_id": 48927,
"reference": {
"external_id": "34567898",
"external_additional_id": "OM656545543"
},
"created_at": {
"date": "2023-01-12 14:19:08.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"type": "shipment",
"courier_id": 814202285,
"courier_name": "DHL",
"courier_logo": "https://company.com/logo.png",
"external_company_name": "Salla Express",
"shipping_number": "0",
"tracking_number": "0",
"pickup_id": 576756,
"trackable": true,
"tracking_link": "https://www.company/tracking/tracking-express.html?submit=1&tracking-id=12345",
"label": [],
"payment_method": "cod",
"source": "api",
"status": "creating",
"total": {
"amount": 100,
"currency": "SAR"
},
"cash_on_delivery": {
"amount": "10.70",
"currency": "SAR"
},
"billing_account": "salla",
"description": "Fashion Apparel - 3 T-Shirts",
"remarks": "Customer requested delivery after 5 PM",
"service_types": [
"international",
"normal",
"fulfillment"
],
"packages": [
{
"item_id": 2077288690,
"external_id": 123212,
"name": "منتج تجريبي",
"sku": "6ytrrhrhr",
"price": {
"amount": "50.00",
"currency": "SAR"
},
"quantity": 2,
"weight": {
"value": "1.00",
"unit": "kg"
},
"options": []
}
],
"ship_from": {
"type": "branch",
"name": "Riyadh",
"email": "",
"phone": "0555555555",
"country": "السعودية",
"country_id": 1473353380,
"city": "RIYADH",
"city_id": 1473353380,
"address_line": "7687 طريق الملك فهد الفرعي,الملك فهد,12262, 7687 طريق الملك فهد الفرعي، الملك فهد، الرياض 12262 3010، السعودية, RIYADH,السعودية",
"street_number": "7687 طريق الملك فهد الفرعي",
"block": "الملك فهد",
"postal_code": "12262",
"latitude": 24.7431373,
"longitude": 46.6570741,
"branch_id": 1723506348
},
"ship_to": {
"type": "address",
"name": "Username",
"email": "username@email.com",
"phone": "055-555-555",
"country": "السعودية",
"country_id": 1473353380,
"city": "الرياض",
"city_id": 1473353380,
"address_line": " شارع 2345، الحي السلام 95128،, شارع عبدالله سنابل السلام مكة السعوديه,, الرياض, السعودية",
"street_number": "2345",
"block": "السلام",
"postal_code": "95128",
"latitude": 21.382590509685,
"longitude": 39.773191030685
},
"meta": {
"app_id": 12345643,
"policy_options": {
"types": "",
"boxes": "1"
}
}
}
}🟠422Validation Error
Modified at 2025-07-07 08:04:13