# Create a new FTL shipment

This endpoint allows you to create a new FTL shipment.

Endpoint: POST /api/v2/ftl/shipments
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `pickup_company_name` (string, required)
    Example: "test"

  - `pickup_contact_name` (string)
    Example: "John"

  - `pickup_contact_email` (string, required)
    Example: "1@1.com"

  - `pickup_contact_phone` (string, required)
    Example: "1234567890"

  - `pickup_contact_phone_ext` (string,null)
    Example: "123"

  - `pickup_address1` (string, required)
    Example: "123 Main St"

  - `pickup_address2` (string,null)
    Example: "Apt 4B"

  - `destination_company_name` (string, required)
    Example: "test"

  - `destination_contact_name` (string)
    Example: "John"

  - `destination_contact_email` (string, required)
    Example: "2@1.com"

  - `destination_contact_phone` (string, required)
    Example: "1234567890"

  - `destination_contact_phone_ext` (string,null)
    Example: "456"

  - `destination_address1` (string, required)
    Example: "456 Elm St"

  - `destination_address2` (string,null)
    Example: "Suite 5"

  - `pickup_open_time` (string, required)
    Example: "08:00"

  - `pickup_close_time` (string, required)
    Example: "17:00"

  - `destination_open_time` (string, required)
    Example: "09:00"

  - `destination_close_time` (string, required)
    Example: "18:00"

  - `customer_reference_number` (string,null)
    Example: "REF123"

  - `pickup_special_request` (string,null)
    Example: "Leave at front desk"

  - `destination_special_request` (string,null)
    Example: "Call upon arrival"

  - `pickup_number` (string,null)

  - `dropoff_number` (string,null)

  - `rate_number` (string, required)
    Rate number from the quote API response
    Example: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

  - `is_insurance_entrusted` (boolean, required)
    Example: true

  - `cargo_value` (integer,null)
    The cargo value will be used in the calculation of the insurance premium.
    Example: 2000

  - `commodity_name` (string, required)
    Example: "Electronics"

  - `total_weight` (integer, required)
    Example: 12345

  - `total_units` (integer, required)
    Example: 50

  - `package_type` (string, required)
    Enum: "Pallet", "Crate"

  - `cartons` (integer, required)
    Example: 123

  - `pickup_time_type` (integer)
    0: Time window and first come first serve, 1: Specific pickup time, 2: Represent me to make an appointment
    Enum: 0, 1, 2

  - `pickup_specific_time` (string,null)
    Example: "10:00"

  - `destination_time_type` (integer)
    0: Time window and first come first serve, 1: Specific destination time, 2: Represent me to make an appointment
    Enum: 0, 1, 2

  - `destination_specific_time` (string,null)
    Example: "15:00"

## Response 201 fields (application/json):

  - `data` (object)

  - `data.order_number` (string, required)
    The order number of the shipment
    Example: "FS241205028749"

## Response 400 fields (application/json):

  - `message` (string)
    Example: "INVALID REQUEST."

## Response 401 fields (application/json):

  - `message` (string)
    Example: "Unauthenticated."

## Response 500 fields (application/json):

  - `message` (string)
    Example: "Internal server error"