Sendcloud - Create Parcel / Label
Description
Section titled “Description”This module creates a parcel in Sendcloud with all recipient data and optionally generates the shipping label. It receives the individual recipient fields (name, company, address, house number, city, zip code, country, phone, email), the shipping method ID, weight, order number, insured value, total value, and whether to generate the label immediately. It makes a POST request to the /parcels endpoint and returns the parcel ID, tracking number, tracking URL, label URL, carrier, and status.
Configuration
Section titled “Configuration”| Parameter | Type | Required | Description |
|---|---|---|---|
| credentials_id | credentials | Yes | Sendcloud credential (provider: sendcloud) |
| name | text | Yes | Recipient name |
| company_name | text | No | Company name |
| address | text | Yes | Street name |
| house_number | text | Yes | House number (required in Europe) |
| address_2 | text | No | Address line 2 |
| city | text | Yes | City |
| postal_code | text | Yes | Zip code |
| country | text | Yes | ISO 2-letter country code (default: ES) |
| telephone | text | No | Phone number |
| text | No | Email address | |
| shipment_id | text | Yes | Shipping method ID (obtained from the Shipping Methods node) |
| weight | text | Yes | Package weight in kg (e.g.: 1.500) |
| order_number | text | No | Internal order number as reference |
| insured_value | text | No | Insured value of the package in cents |
| total_order_value | text | No | Total order value |
| request_label | boolean | No | Generate label immediately (default: true) |
Credentials
Section titled “Credentials”A sendcloud type credential is required with the following fields:
- public_key: Sendcloud Public Key
- secret_key: Sendcloud Secret Key
Credentials are obtained from the Sendcloud dashboard (https://app.sendcloud.com/v2/settings/integrations).
Output
Section titled “Output”{ "success": true, "parcel_id": 12345, "tracking_number": "3STEST123456789", "tracking_url": "https://tracking.sendcloud.sc/...", "label_url": "https://panel.sendcloud.sc/api/v2/labels/...", "carrier": "correos_express", "status": "Ready to send", "order_number": "ORD-001", "message": "Paquete creado - Tracking: 3STEST123456789"}Usage Example
Section titled “Usage Example”Basic case
Section titled “Basic case”{ "credentials_id": "mi_credencial_sendcloud", "name": "Juan Garcia", "address": "Calle Mayor", "house_number": "10", "city": "Madrid", "postal_code": "28001", "country": "ES", "shipment_id": "8", "weight": "1.500", "request_label": true}API Used
Section titled “API Used”- Endpoint: POST
/parcels - Base: Sendcloud API (via helper
_sendcloudHelper) - Documentation: https://docs.sendcloud.sc/api/v2/
- The house number (house_number) is required for European addresses
- The shipment_id is the shipping method ID, not the parcel ID; it is obtained with the Shipping Methods node
- Weight is expressed in kilograms with 3 decimals (e.g.: 1.500)
- The insured value is expressed in cents (e.g.: 5000 = 50.00 EUR)
- Authentication uses Basic Auth with public_key and secret_key
- If request_label is false, the parcel is created without a label and it can be generated later