curl --request POST \
--url https://panel.sendcloud.sc/api/v3/shipping-rules/rules \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Insure high-value orders",
"is_active": true,
"criteria": {
"is_and": true,
"conditions": [
{
"property": "order_value",
"operator": "ge",
"compare_to": "200"
}
]
},
"actions": [
{
"identifier": "insurance_pc",
"value": "100"
}
]
}
'{
"id": 1,
"name": "Insure high-value parcels",
"is_active": true,
"is_invalid": false,
"order": 1,
"updated_at": "2026-06-26T10:15:00Z",
"criteria": {
"is_and": true,
"conditions": [
{
"property": "total_order_value",
"operator": "greater_than",
"compare_to": "100"
}
]
},
"actions": [
{
"identifier": "set_insurance",
"value": "500"
}
]
}{
"errors": [
{
"id": "<string>",
"links": {
"about": "<string>"
},
"status": "<string>",
"code": "unknown_field",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>",
"parameter": "<string>",
"header": "<string>"
},
"meta": {}
}
]
}Shipping rules
Create a shipping rule
Create a shipping rule that applies its actions to a shipment whenever the shipment matches its conditions.
POST
/
shipping-rules
/
rules
curl --request POST \
--url https://panel.sendcloud.sc/api/v3/shipping-rules/rules \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Insure high-value orders",
"is_active": true,
"criteria": {
"is_and": true,
"conditions": [
{
"property": "order_value",
"operator": "ge",
"compare_to": "200"
}
]
},
"actions": [
{
"identifier": "insurance_pc",
"value": "100"
}
]
}
'{
"id": 1,
"name": "Insure high-value parcels",
"is_active": true,
"is_invalid": false,
"order": 1,
"updated_at": "2026-06-26T10:15:00Z",
"criteria": {
"is_and": true,
"conditions": [
{
"property": "total_order_value",
"operator": "greater_than",
"compare_to": "100"
}
]
},
"actions": [
{
"identifier": "set_insurance",
"value": "500"
}
]
}{
"errors": [
{
"id": "<string>",
"links": {
"about": "<string>"
},
"status": "<string>",
"code": "unknown_field",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>",
"parameter": "<string>",
"header": "<string>"
},
"meta": {}
}
]
}OAuth2 scopes required:
write:shipping-rule. See Scopes for OAuth apps.Authorizations
HTTPBasicAuthOAuth2ClientCreds
Body
application/json
Payload to create a shipping rule.
Response
Created
A shipping rule including its conditions and actions.