> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.quivo.co/llms.txt > Use this file to discover all available pages before exploring further. # Create inbound shipment > Create a new inbound shipment or inbound delivery. ## OpenAPI ````yaml /openapi.json post /inbounds openapi: 3.0.1 info: title: Connector version: 80f7edc, 2026-01-23T12:01:00Z description: Enhanced Quivo API documentation with additional descriptions and examples contact: name: Quivo Support email: support@quivo.co url: https://quivo.co license: name: Proprietary url: https://quivo.co/terms termsOfService: https://quivo.co/terms servers: - url: https://api.quivo.co/ description: Production API server for Quivo Connector security: [] tags: - name: addresses description: Manage stored addresses in the seller's address book - name: apiKeyRequests description: Request and manage API keys - name: articles description: Create and manage product articles - name: audits description: Access audit logs and history - name: bundles description: Manage product bundles - name: carriers description: Get carrier information - name: contacts description: Manage contact information - name: countries description: Get country information - name: currencies description: Get currency information - name: customerInquiries description: Manage customer inquiries - name: dashboards description: Access dashboard data - name: files description: Manage file uploads and downloads - name: fulfillmentPlans description: Manage fulfillment plans - name: inbounds description: Manage inbound shipments - name: items description: Monitor and manage inventory items - name: languages description: Get language information - name: notifications description: Manage notifications - name: orders description: Create and manage fulfillment orders - name: ping description: Health check endpoint - name: returnApp description: Manage return applications - name: returnLinks description: Manage return links - name: returns description: Manage returns - name: sellers description: Get seller information - name: shipments description: Book and manage shipments - name: shippingServiceGroups description: Get shipping service groups - name: shopOrders description: Manage shop orders - name: shops description: Manage shops - name: status description: Get system status - name: storedAddresses description: Manage stored addresses - name: subscriptionPackages description: Manage subscription packages - name: subscriptions description: Manage webhook subscriptions - name: track description: Track shipments - name: transports description: Manage transport services - name: users description: Manage users - name: warehouses description: Get warehouse information paths: /inbounds: post: tags: - inbounds summary: Create inbound shipment description: Create a new inbound shipment or inbound delivery. operationId: postInbound requestBody: content: application/json: schema: $ref: '#/components/schemas/InboundPost' required: false description: Data to create a new resource at /inbounds responses: '200': description: >- Returns the result of the inbound shipment creation, including assigned identifiers and validation status. content: application/json: schema: $ref: '#/components/schemas/InboundPostResult' '400': description: >- Bad request - the request payload is invalid, missing required fields, or contains invalid data. '401': description: >- Unauthorized - authentication credentials are missing, invalid, or expired. '404': description: >- Not found - the requested resource does not exist or is not accessible. '500': description: Internal server error - an unexpected error occurred on the server. components: schemas: InboundPost: required: - deliveryInfo - deliverySlipNumber - estimatedArrivalTime - inboundPositions - sellerId - shipFrom - trackingNumber - warehouseId type: object properties: sellerId: type: integer description: Seller ID. format: int64 warehouseId: type: integer description: >- Warehouse ID.
A list of warehouse identifiers and names can be obtained by executing GET /warehouses format: int64 shipFrom: $ref: '#/components/schemas/AddressDetail' estimatedArrivalTime: type: string description: Estimated date of arrival format: date-time deliverySlipNumber: type: string description: Delivery slip number customAttributes: type: object additionalProperties: type: string description: Optional custom attributes of this inbound. example: '{"attr1":"val1"}' movementReferenceNumber: maxLength: 1024 minLength: 0 type: string description: >- Optional movement reference number. Unique identifier assigned to customs declarations within the UK and EU inboundPositions: type: array description: List of inbound positions items: $ref: '#/components/schemas/InboundPositionDetailPost' deliveryInfo: $ref: '#/components/schemas/InboundDeliveryInfoDetail' trackingNumber: type: string description: Optional tracking number carrier: type: string description: Optional carrier comments: type: string description: Comments. deliverySlipDate: type: string description: Optional date of the creation of the delivery slip format: date-time externalIdentifier: maxLength: 25 minLength: 0 type: string description: Optional identifier. Can be a freight number or container number tags: type: array description: Optional tags of this inbound items: type: string inboundReference: maxLength: 40 minLength: 0 type: string description: Optional additional reference of this Inbound. description: >- Request payload for creating a new inbound shipment or inbound delivery. Contains inbound shipment details including expected items, quantities, warehouse destination, and delivery dates. InboundPostResult: type: object properties: status: type: string description: The current status of the item inboundId: type: integer format: int64 description: The unique identifier for the inbound field: type: string description: The field value message: type: string description: Message content description: >- Result of creating an inbound shipment. Contains inbound shipment identifier and processing status. AddressDetail: type: object properties: name1: type: string description: The name of the item name2: type: string description: The name of the item company: type: string description: Company name address1: type: string description: Address information address2: type: string description: Address information address3: type: string description: Address information zip: type: string description: ZIP or postal code city: type: string description: City name state: type: string description: State or province country: type: string description: Country code or name phone: type: string description: Phone number email: type: string description: Email address description: Detailed address information InboundPositionDetailPost: required: - quantity - sku type: object properties: quantity: minimum: 1 type: integer description: Number of units of the position. format: int32 sku: type: string description: Position SKU. lot: type: string description: Optional position lot. location: type: string description: Optional position location. expirationDate: type: string description: Optional position expiration date. format: date serialNumbers: type: array description: Optional position serial numbers. items: type: string positionNumber: maxLength: 25 minLength: 0 type: string description: Optional position number or identifier customAttributes: type: object additionalProperties: type: string description: Optional custom attributes of this inbound position. example: '{"attr1":"val1"}' description: Request object for creating inboundpositiondetail InboundDeliveryInfoDetail: required: - cargoType - quantity type: object properties: cargoType: type: string description: Cargo type. enum: - CARTON - PALLET - CONTAINER quantity: minimum: 1 type: integer description: Cargo quantity. format: int32 description: Detailed information for inbounddeliveryinfo ````