---
updatedAt: 2026-08-12T16:21:03.000Z
agentTools:
projectIndex: https://docs.shipfusion.com/llms.txt
---
# Create Outbound Shipment
Creates a shipment to be shipped by Shipfusion
# OpenAPI definition
```json
{
"openapi": "3.0.3",
"info": {
"title": "Shipfusion REST API",
"version": "1.1",
"description": "Shipfusion REST API.\n\n**Basic Authentication** is required on all requests.\n"
},
"servers": [
{
"url": "https://api.shipfusion.com/v1",
"description": "Production"
}
],
"security": [
{
"X-SHIPFUSION-TOKEN": []
}
],
"tags": [
{
"name": "Outbound Shipments",
"description": "Create, list, view, search, update, cancel, hold and resubmit outbound shipments."
}
],
"paths": {
"/shipments": {
"post": {
"tags": [
"Outbound Shipments"
],
"summary": "Create Outbound Shipment",
"operationId": "createShipment",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"orderNumber",
"orderDate",
"toAddress",
"items",
"warehouse"
],
"properties": {
"orderNumber": {
"type": "string",
"description": "Your internal order number",
"example": "ORD100004"
},
"orderDate": {
"type": "string",
"description": "The date the order was made (YYYYMMDD)",
"example": "20160131"
},
"warehouse": {
"type": "string",
"description": "The warehouse you are shipping from",
"example": "IL",
"enum": [
"IL",
"LV",
"PA",
"TO"
]
},
"packingSlipMessage": {
"type": "string",
"description": "Custom message to be included on packing slip",
"example": "Please enjoy coupon code XXX"
},
"specialInstructions": {
"type": "string",
"description": "Special instructions to be reviewed by warehouse",
"example": "Please add fragile sticker to packaging"
},
"signature": {
"type": "number",
"description": "Request a signature if available with selected carrier and service",
"example": 1
},
"insurance": {
"type": "number",
"description": "Request insurance on shipment",
"example": 100
},
"customsOverrideDiscount": {
"type": "number",
"description": "A customs discount applied to the entire order that is split evenly across all items in the shipment",
"example": 100
},
"shippingCarrier": {
"type": "string",
"description": "Carrier to ship with (see Carriers / Services)",
"example": "USPS"
},
"shippingService": {
"type": "string",
"description": "Service to ship with (see Carriers / Services)",
"example": "First"
},
"priorityBump": {
"type": "number",
"description": "Mark this shipment as a priority so it will get processed first",
"example": 1
},
"customPackingSlipURL": {
"type": "string",
"description": "URL of PDF file to include in shipment",
"example": "www.xx.com/slip.pdf"
},
"toAddress": {
"type": "object",
"required": [
"firstName",
"lastName",
"address1",
"city",
"state",
"zipPostalCode",
"country",
"phoneNumber",
"emailAddress"
],
"properties": {
"firstName": {
"type": "string",
"description": "Recipient's first name",
"example": "John"
},
"lastName": {
"type": "string",
"description": "Recipient's last name",
"example": "Smith"
},
"companyName": {
"type": "string",
"description": "Recipient's company name",
"example": "JS Inc."
},
"address1": {
"type": "string",
"description": "Address Line 1",
"example": "1870 International Blvd."
},
"address2": {
"type": "string",
"description": "Address Line 2",
"example": "Unit 1"
},
"city": {
"type": "string",
"description": "The city",
"example": "Chicago"
},
"state": {
"type": "string",
"description": "The state/province",
"example": "IL"
},
"zipPostalCode": {
"type": "string",
"description": "Zip/postal code",
"example": "60139"
},
"country": {
"type": "string",
"description": "2 digit country code",
"example": "US"
},
"phoneNumber": {
"type": "string",
"description": "Recipient's phone number",
"example": "+1647-261-0224"
},
"emailAddress": {
"type": "string",
"description": "Recipient's email address",
"example": "johnsmith@gmail.com"
}
}
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"SKU",
"qty"
],
"properties": {
"SKU": {
"type": "string",
"description": "Unique product SKU",
"example": "ABC"
},
"qty": {
"type": "number",
"description": "Quantity of specified SKU",
"example": 1
},
"customsOverridePrice": {
"type": "number",
"description": "Customs price applied to the single line item. Overrides any price stored on the Shipfusion system.",
"example": 100
},
"customsOverrideDescription": {
"type": "string",
"description": "Customs description applied to the single line item. Overrides any description stored on the Shipfusion system.",
"example": "Natural Vitamin Supplements"
}
}
}
}
}
},
"example": {
"orderNumber": "ORD100004",
"orderDate": "20160131",
"warehouse": "IL",
"packingSlipMessage": "",
"specialInstructions": "",
"signature": 0,
"insurance": 0,
"shippingCarrier": "USPS",
"shippingService": "First",
"priorityBump": 0,
"toAddress": {
"firstName": "John",
"lastName": "Smith",
"companyName": "",
"address1": "1870 Internationale Blvd.",
"address2": "",
"city": "Glendale Heights",
"state": "IL",
"zipPostalCode": "60139",
"country": "US",
"phoneNumber": "+1647-261-0221",
"emailAddress": "johnsmith@gmail.com"
},
"items": [
{
"SKU": "ABC",
"qty": 1
},
{
"SKU": "DEF",
"qty": 2
}
]
}
}
}
},
"responses": {
"200": {
"description": "Shipment created successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"responseStatus": {
"type": "string",
"example": "success"
},
"shipmentId": {
"type": "string",
"example": "SFD-30A1-C78F"
},
"message": {
"type": "string",
"example": "Shipment has been created successfully"
}
}
},
"example": {
"responseStatus": "success",
"shipmentId": "SFD-30A1-C78F",
"message": "Shipment has been created successfully"
}
}
}
}
},
"description": "Creates a shipment to be shipped by Shipfusion"
}
}
},
"components": {
"securitySchemes": {
"X-SHIPFUSION-TOKEN": {
"type": "apiKey",
"in": "header",
"name": "X-SHIPFUSION-TOKEN"
}
}
},
"x-readme": {}
}
```