Shippo - Create Shipment / Label

Description

This module creates a shipment in Shippo by purchasing a previously selected rate. It receives the rate ID (obtained from the Get Rates node), the label format, and optional metadata/reference. It makes a synchronous POST request to the /transactions/ endpoint and returns the transaction ID, tracking number, carrier tracking URL, label URL, commercial invoice URL, ETA, status, and error messages if any.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Shippo credential (provider: shippo)
rate_id	text	Yes	Rate ID obtained with the Get Rates node
label_file_type	select	No	Label format: PDF (default), PDF_4x6, PDF_A4, PDF_A6, PNG, ZPLII
metadata	text	No	Internal reference or notes for this shipment

Credentials

A shippo type credential is required with the following fields:

api_token: Shippo API Token

Credentials are obtained from the Shippo dashboard (https://apps.goshippo.com/settings/api).

Output

{
  "success": true,
  "transaction_id": "txn_abc123",
  "tracking_number": "9400111899223456789012",
  "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400111899223456789012",
  "label_url": "https://shippo-delivery.s3.amazonaws.com/label.pdf",
  "commercial_invoice_url": null,
  "eta": "2026-03-25T18:00:00Z",
  "status": "SUCCESS",
  "messages": [],
  "message": "Etiqueta generada - Tracking: 9400111899223456789012"
}

Usage Example

Basic case

{
  "credentials_id": "mi_credencial_shippo",
  "rate_id": "rate_abc123",
  "label_file_type": "PDF",
  "metadata": "Pedido #1234"
}

API Used

Endpoint: POST /transactions/
Base: Shippo API (via helper _shippoHelper)
Documentation: https://goshippo.com/docs/

Notes

This node requires a prior rate_id from the Get Rates node
The transaction is executed synchronously (async: false)
The SUCCESS status indicates that the label was generated correctly
If there are errors, they are included in the messages field with details
Shippo supports multiple label formats including specific formats like PDF_4x6 and PDF_A6
The transaction_id is needed to cancel/refund the shipment