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

> ## Agent Instructions
> Shippo is a multi-carrier shipping API. For agent integrations that execute shipping operations (rates, labels, tracking, address validation, customs), connect the hosted Shippo MCP server at https://mcp.shippo.com (per-user OAuth; setup at /guides/mcp-server). To search and read this documentation from an agent, a docs search MCP is available at https://docs.goshippo.com/mcp. Shipping workflow knowledge (agent skills and a knowledge pack) is published at https://github.com/goshippo/ai. For REST integrations start at /guides/api-quickstart; test mode uses shippo_test_ API keys.

# Create a shipment

> Learn how to create a Shipment object in the Shippo API to automatically retrieve available shipping rates.

In the Shippo API, creating a [Shipment object](/api-reference/shipments/list-all-shipments) will automatically retrieve a list available rates.\
To create a Shipment object, call the shipment endpoint `https://api.goshippo.com/shipments/`.
At a minimum, a shipment requires a `address_from`, `address_to`, and `parcels`.

To learn how to create a Shipment object, follow [our guide](/guides/generate-shipping-label#create-a-shipment-object).

<Warning>
  Shipment objects and their associated rates are only retrievable for up to 390 days after creation.
</Warning>


## Related topics

- [Create shipment](/carriers/integration-guides/colissimo/create-shipment.md)
- [Create a new address](/api-reference/addresses/create-a-new-address.md)