POST
/
api
/
v1
/
loads
{
  "event_type": "load_create",
  "org_id": "123e4567-e89b-12d3-a456-426614174000",
  "custom_load_id": "LOAD123",
  "contact": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "555-0123",
    "type": "Sales Rep"
  },
  "origin": {
    "city": "Chicago",
    "state": "IL",
    "zip_code": "60601",
    "country": "USA"
  },
  "destination": {
    "city": "New York",
    "state": "NY",
    "zip_code": "10001",
    "country": "USA"
  },
  "stops": [
    {
      "type": "Pick",
      "location": {
        "city": "Chicago",
        "state": "IL",
        "zip_code": "60601",
        "country": "USA"
      },
      "stop_timestamp_open": "2024-03-20T14:00:00Z",
      "stop_timestamp_close": "2024-03-20T16:00:00Z",
      "stop_order": 1
    },
    {
      "type": "Delivery",
      "location": {
        "city": "New York",
        "state": "NY",
        "zip_code": "10001",
        "country": "USA"
      },
      "stop_timestamp_open": "2024-03-21T14:00:00Z",
      "stop_timestamp_close": "2024-03-21T16:00:00Z",
      "stop_order": 2
    }
  ],
  "equipment_type_name": "Dry Van",
  "max_buy": 1500.50,
  "status": "Available",
  "posted_carrier_rate": 1200.00,
  "weight": 40000,
  "number_of_pieces": 100,
  "miles": 500,
  "pickup_date": "2024-03-20T14:00:00Z",
  "pickup_timezone": "America/Chicago",
  "delivery_date": "2024-03-21T16:00:00Z",
  "delivery_timezone": "America/New_York"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174003",
  "created_at": "2024-03-19T08:00:00Z",
  "status": "Available",
  "custom_load_id": "LOAD123"
}

Create a new load with all associated details including pickup/delivery information, equipment requirements, and pricing.

​
Authentication

This endpoint requires a Bearer token in the Authorization header:

Authorization: Bearer <your_token>

​
Body

​
event_type
string
required

Type of event. For now, only ‘load_upsert’ is supported.

​
contact
object

Contact information for this load

​
type
enum
default:
"owned"

Type of load. Must be one of: - can-get - owned

​
custom_load_id
string
required

Custom identifier for the load

​
stops
array

List of stops for this load

​
max_buy
number

Maximum buying rate for the load

​
status
enum
required

Load status. Must be one of: - Available - Covered - Eload - ThirdShift - Hold - EloadFortus - AcceptingOffers - Unavailable

​
is_partial
boolean
default:
"false"

Whether this is a partial load

​
posted_carrier_rate
number
required

Rate posted for carriers

​
sale_notes
string

Additional notes about the sale

​
branch
string

Branch handling the load

​
commodity_type
string

Type of commodity being transported

​
weight
number

Weight of the load in pounds

​
number_of_pieces
integer

Number of pieces in the load

​
miles
integer

Total miles for the trip

​
dimensions
string

Dimensions of the load

​
equipment_type_name
string
required

Name of the required equipment type

​
Response

​
id
string

The UUID of the created load

​
created_at
string

ISO 8601 formatted creation timestamp

{
  "event_type": "load_create",
  "org_id": "123e4567-e89b-12d3-a456-426614174000",
  "custom_load_id": "LOAD123",
  "contact": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "555-0123",
    "type": "Sales Rep"
  },
  "origin": {
    "city": "Chicago",
    "state": "IL",
    "zip_code": "60601",
    "country": "USA"
  },
  "destination": {
    "city": "New York",
    "state": "NY",
    "zip_code": "10001",
    "country": "USA"
  },
  "stops": [
    {
      "type": "Pick",
      "location": {
        "city": "Chicago",
        "state": "IL",
        "zip_code": "60601",
        "country": "USA"
      },
      "stop_timestamp_open": "2024-03-20T14:00:00Z",
      "stop_timestamp_close": "2024-03-20T16:00:00Z",
      "stop_order": 1
    },
    {
      "type": "Delivery",
      "location": {
        "city": "New York",
        "state": "NY",
        "zip_code": "10001",
        "country": "USA"
      },
      "stop_timestamp_open": "2024-03-21T14:00:00Z",
      "stop_timestamp_close": "2024-03-21T16:00:00Z",
      "stop_order": 2
    }
  ],
  "equipment_type_name": "Dry Van",
  "max_buy": 1500.50,
  "status": "Available",
  "posted_carrier_rate": 1200.00,
  "weight": 40000,
  "number_of_pieces": 100,
  "miles": 500,
  "pickup_date": "2024-03-20T14:00:00Z",
  "pickup_timezone": "America/Chicago",
  "delivery_date": "2024-03-21T16:00:00Z",
  "delivery_timezone": "America/New_York"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174003",
  "created_at": "2024-03-19T08:00:00Z",
  "status": "Available",
  "custom_load_id": "LOAD123"
}

Was this page helpful?

Get Loads