> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beachdepository.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Outbound Shipment

> Create an outbound shipment with inventory items

Creates an outbound shipment to ship one or more inventory items out of the vault for an FBO account.
Every item must currently belong to the FBO account and be in an `in_vault` status.

The response returns a `status` of `created`. Cancel is available while the `status` is `created`.
Requested items remain `in_vault`. [Get Inventory Item](/api-reference/inventory/get) sets
`openOutboundRequestId` to this shipment's id.

Send `destinationAddress` or `destinationAddressId` for where the package ships. `shipping.service`
is `cheapest` or a `service` from [Get Outbound Shipment
Rates](/api-reference/outbound-shipments/get-rates).

**Permission:** `outbound_shipments:create`

## Request body

<ParamField body="fboAccountId" type="string" required>
  ID of the FBO account requesting the outbound shipment.
</ParamField>

<ParamField body="notes" type="string">
  Optional free-text note describing the shipment.
</ParamField>

<ParamField body="destinationAddress" type="object">
  Where the package goes.

  <Expandable title="address properties">
    <ParamField body="street1" type="string" required>
      Street address line 1.
    </ParamField>

    <ParamField body="city" type="string" required>
      City.
    </ParamField>

    <ParamField body="state" type="string" required>
      State or province.
    </ParamField>

    <ParamField body="zip" type="string" required>
      Postal code.
    </ParamField>

    <ParamField body="country" type="string" required>
      Country code (for example `US`).
    </ParamField>

    <ParamField body="street2" type="string">
      Street address line 2.
    </ParamField>

    <ParamField body="name" type="string">
      Recipient name.
    </ParamField>

    <ParamField body="company" type="string">
      Company or organization name.
    </ParamField>

    <ParamField body="phone" type="string">
      Contact phone.
    </ParamField>

    <ParamField body="email" type="string">
      Contact email.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="destinationAddressId" type="string">
  ID of a saved address from [list FBO account
  addresses](/api-reference/fbo-accounts/list-addresses). Copied onto the shipment. Cannot be sent
  with `destinationAddress`.
</ParamField>

<ParamField body="shipping" type="object">
  Carrier service for the shipment.

  <Expandable title="shipping properties">
    <ParamField body="service" type="string">
      `cheapest`, or a `service` from [Get Outbound Shipment
      Rates](/api-reference/outbound-shipments/get-rates) such as `FEDEX_GROUND`.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="items" type="array" required>
  The inventory items to include — at least one. Each entry contains:

  * `inventoryItemId` (string, required) — ID of the inventory item to ship out.

  `inventoryItemId` values must be unique within the shipment.
</ParamField>

<RequestExample>
  ```json Cheapest theme={null}
  {
    "fboAccountId": "m97fbo456",
    "notes": "Ship to primary address",
    "destinationAddress": {
      "name": "Jane Doe",
      "street1": "123 Main St",
      "city": "Dallas",
      "state": "TX",
      "zip": "75001",
      "country": "US"
    },
    "shipping": { "service": "cheapest" },
    "items": [{ "inventoryItemId": "jk7inv456" }]
  }
  ```

  ```json Saved address theme={null}
  {
    "fboAccountId": "m97fbo456",
    "destinationAddressId": "ja7addr123",
    "shipping": { "service": "cheapest" },
    "items": [{ "inventoryItemId": "jk7inv456" }]
  }
  ```

  ```json Selected service theme={null}
  {
    "fboAccountId": "m97fbo456",
    "destinationAddress": {
      "name": "Jane Doe",
      "street1": "123 Main St",
      "city": "Dallas",
      "state": "TX",
      "zip": "75001",
      "country": "US"
    },
    "shipping": {
      "service": "FEDEX_GROUND"
    },
    "items": [{ "inventoryItemId": "jk7inv456" }]
  }
  ```
</RequestExample>

## Response

Returns the created outbound shipment with its line items.

```json Response theme={null}
{
  "data": {
    "id": "jd7abc123xyz",
    "fboAccountId": "m97fbo456",
    "organizationId": "k57orgxyz",
    "status": "created",
    "totalItems": 1,
    "notes": "Ship to primary address",
    "destinationAddress": {
      "name": "Jane Doe",
      "street1": "123 Main St",
      "city": "Dallas",
      "state": "TX",
      "zip": "75001",
      "country": "US"
    },
    "shipping": {
      "service": "cheapest"
    },
    "packages": [],
    "items": [
      {
        "id": "j970item123",
        "outboundShipmentId": "jd7abc123xyz",
        "productId": "jh7prod123",
        "inventoryItemId": "jk7inv456",
        "createdAt": "2025-06-15T09:00:00Z"
      }
    ],
    "createdAt": "2025-06-15T09:00:00Z"
  }
}
```

<Note>This endpoint supports the [`Idempotency-Key`](/getting-started#idempotency) header.</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.