Create Branch Delivery Zone

Production

https://api.salla.dev/admin/v2

POST

/branches/delivery-zones

Last modified:2025-10-16 14:28:54

This endpoint is using for creating a new delivery zone and defining a branch’s delivery coverage by specifying its status and setting the area using either a radius or polygon coordinates

This endpoint is accessable only for allowed applications.

Scopes

branches.read_write - Branchs Read & Write

Request

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

{
	"status": true,
	"branch_id": 525010325,
	"rules": {
		"coverage": {
			"enabled": true,
			"method": "polygon",
			"coordinates": [
				{
					"lat": 24.919427692528,
					"lng": 46.7360729
				},
				{
					"lat": 24.840317240711,
					"lng": 46.138643243018
				},
				{
					"lat": 24.506501651095,
					"lng": 46.168807580176
				},
				{
					"lat": 24.407746339329,
					"lng": 46.55411184043
				},
				{
					"lat": 24.608925155159,
					"lng": 46.763634850684
				},
				{
					"lat": 24.766767432571,
					"lng": 47.065710808936
				},
				{
					"lat": 24.919427692528,
					"lng": 46.7360729
				}
			]
		},
		"working_hours": {
			"sunday": {
				"enabled": "on",
				"from": [
					"08:00",
					"19:00"
				],
				"to": [
					"17:00",
					"23:30"
				]
			},
			"monday": {
				"enabled": "on",
				"from": [
					"08:00",
					"19:00"
				],
				"to": [
					"17:00",
					"23:30"
				]
			}
		}
	}
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.salla.dev/admin/v2/branches/delivery-zones' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
	"status": true,
	"branch_id": 525010325,
	"rules": {
		"coverage": {
			"enabled": true,
			"method": "polygon",
			"coordinates": [
				{
					"lat": 24.919427692528,
					"lng": 46.7360729
				},
				{
					"lat": 24.840317240711,
					"lng": 46.138643243018
				},
				{
					"lat": 24.506501651095,
					"lng": 46.168807580176
				},
				{
					"lat": 24.407746339329,
					"lng": 46.55411184043
				},
				{
					"lat": 24.608925155159,
					"lng": 46.763634850684
				},
				{
					"lat": 24.766767432571,
					"lng": 47.065710808936
				},
				{
					"lat": 24.919427692528,
					"lng": 46.7360729
				}
			]
		},
		"working_hours": {
			"sunday": {
				"enabled": "on",
				"from": [
					"08:00",
					"19:00"
				],
				"to": [
					"17:00",
					"23:30"
				]
			},
			"monday": {
				"enabled": "on",
				"from": [
					"08:00",
					"19:00"
				],
				"to": [
					"17:00",
					"23:30"
				]
			}
		}
	}
}'

Responses

🟢200Success

application/json

Body

Example

{
    "status": 201,
    "success": true,
    "data": {
        "id": 2079537577,
        "branch_id": 525010325,
        "status": true,
        "rules": {
            "coverage": {
                "enabled": true,
                "method": "polygon",
                "radius_meters": null,
                "coordinates": [
                    {
                        "lat": 24.919427692528,
                        "lng": 46.7360729
                    },
                    {
                        "lat": 24.840317240711,
                        "lng": 46.138643243018
                    },
                    {
                        "lat": 24.506501651095,
                        "lng": 46.168807580176
                    },
                    {
                        "lat": 24.407746339329,
                        "lng": 46.55411184043
                    },
                    {
                        "lat": 24.608925155159,
                        "lng": 46.763634850684
                    },
                    {
                        "lat": 24.766767432571,
                        "lng": 47.065710808936
                    },
                    {
                        "lat": 24.919427692528,
                        "lng": 46.7360729
                    },
                    {
                        "lat": 24.919427692528,
                        "lng": 46.7360729
                    }
                ]
            },
            "working_hours": [
                {
                    "name": "الأحد",
                    "times": [
                        {
                            "from": "08:00",
                            "to": "17:00"
                        },
                        {
                            "from": "19:00",
                            "to": "23:30"
                        }
                    ]
                },
                {
                    "name": "الإثنين",
                    "times": [
                        {
                            "from": "08:00",
                            "to": "17:00"
                        },
                        {
                            "from": "19:00",
                            "to": "23:30"
                        }
                    ]
                }
            ]
        }
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

Modified at 2025-10-16 14:28:54

Branch Delivery Zone Details

Update Branch Delivery Zone