E-commerce API
POST /services/webshop/v1/orders/sendcloud/shipments/create-label Auth

Create Shipping Labels

This endpoint validates shipments and queues them for batch label processing. Actual SendCloud API communication happens asynchronously in jobs.

Request Body Required

FieldTypeRequiredDescriptionExample
order_ids integer[] Yes [1,2,3]

Responses

500
200
400
404
422
401
403
429
Internal server error
Headers
HeaderTypeDescriptionExample
X-RateLimit-Limit integer Maximum number of requests allowed per minute 60
X-RateLimit-Remaining integer Number of requests remaining in the current window 57
FieldTypeDescription
error boolean
message string
Successful response
Headers
HeaderTypeDescriptionExample
X-RateLimit-Limit integer Maximum number of requests allowed per minute 60
X-RateLimit-Remaining integer Number of requests remaining in the current window 57
FieldTypeDescription
error boolean
message string
batch_name string
total_orders integer
new_orders integer
retried_orders integer
skipped_orders integer
total_chunks integer
estimated_completion_minutes number
status_check_url string ~1.5 minutes per chunk (individual API calls are faster)
Bad request
Headers
HeaderTypeDescriptionExample
X-RateLimit-Limit integer Maximum number of requests allowed per minute 60
X-RateLimit-Remaining integer Number of requests remaining in the current window 57
FieldTypeDescription
error boolean
message string
Resource not found
Headers
HeaderTypeDescriptionExample
X-RateLimit-Limit integer Maximum number of requests allowed per minute 60
X-RateLimit-Remaining integer Number of requests remaining in the current window 57
FieldTypeDescription
error boolean
message string
Validation error
FieldTypeDescription
message string Errors overview.
errors object A detailed description of each field that failed validation.
Unauthenticated — missing or invalid Bearer token
Headers
HeaderTypeDescriptionExample
X-RateLimit-Limit integer Maximum number of requests allowed per minute 60
X-RateLimit-Remaining integer Number of requests remaining in the current window 57
FieldTypeDescription
error boolean
message string
Forbidden — insufficient permissions for this resource
Headers
HeaderTypeDescriptionExample
X-RateLimit-Limit integer Maximum number of requests allowed per minute 60
X-RateLimit-Remaining integer Number of requests remaining in the current window 57
FieldTypeDescription
error boolean
message string
Too Many Requests — rate limit exceeded
Headers
HeaderTypeDescriptionExample
X-RateLimit-Limit integer Maximum number of requests allowed per minute 60
X-RateLimit-Remaining integer Number of requests remaining in the current window 57
Retry-After integer Seconds until the rate limit resets 60
FieldTypeDescription
error boolean
message string
Base URL
https://api.wemasy.nl/api
Authentication
Request Sample
cURL
JS
PHP
Python
curl -X POST "https://api.wemasy.nl/api/services/webshop/v1/orders/sendcloud/shipments/create-label" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "order_ids": [
        1,
        2,
        3
    ]
}'
fetch('https://api.wemasy.nl/api/services/webshop/v1/orders/sendcloud/shipments/create-label', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "order_ids": [
        1,
        2,
        3
    ]
})})
.then(r => r.json())
.then(data => console.log(data));
$response = Http::withToken('YOUR_API_TOKEN')
    ->accept('application/json')
    ->post('https://api.wemasy.nl/api/services/webshop/v1/orders/sendcloud/shipments/create-label', {
    "order_ids": [
        1,
        2,
        3
    ]
});
$data = $response->json();
import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
data = {
    "order_ids": [
        1,
        2,
        3
    ]
}
r = requests.post("https://api.wemasy.nl/api/services/webshop/v1/orders/sendcloud/shipments/create-label", headers=headers, json=data)
print(r.json())
Response Example
{
    "error": false,
    "message": "string",
    "batch_name": "string",
    "total_orders": 0,
    "new_orders": 0,
    "retried_orders": 0,
    "skipped_orders": 0,
    "total_chunks": 0,
    "estimated_completion_minutes": 0,
    "status_check_url": "string"
}
Try It
Request Body Required
Export