Create Load API (Lead Source Integration Guide) – Dispatchable Knowledgebase

Overview

The Create Load API allows you to send customer quotes, load requests, or shipment data directly into Dispatchable from external systems such as:

Web forms (JotForm, Typeform, custom forms)
CRM systems
Marketing funnels
Third-party integrations

This is commonly used for lead sources under:

Settings → Data Management → Lead Sources → API

🔗 Full Developer Documentation

For full technical details, including all available fields and advanced options:

👉 https://developer.dispatchable.com/create-load-32146275e0

Endpoint

POST /loads/api/v1/from-source

Authentication

All requests require an API Key, which can be found in:

Settings → Data Management → Lead Sources → API

Include the API key in the request body:

{
  "api_key": "your_api_key_here"
}

Basic Example (Auto Transport)

{
  "api_key": "716liOql9s7GJtvvmTwufBPxlPWn45wE",
  "origin_city": "Los Angeles",
  "origin_state": "CA",
  "origin_zip": "90001",
  "destination_city": "New York",
  "destination_state": "NY",
  "destination_zip": "10001",
  "trailer_type": "OPEN",
  "load_type": "auto_transport",
  "first_avail": "2025-07-01",
  "customer_first_name": "Jane",
  "customer_last_name": "Doe",
  "customer_phone_1": "+15555555555",
  "customer_email": "jane@example.com",
  "vehicles": [
    {
      "vehicle_year": "2022",
      "vehicle_make": "Toyota",
      "vehicle_model": "Camry",
      "vehicle_type": "CAR",
      "is_operational": true
    }
  ]
}

Required Fields

The following fields are required for all requests:

api_key
trailer_type
customer_first_name
customer_last_name
customer_phone_1
customer_email

Vehicle Requirements (Auto Transport)

If load_type = auto_transport, you must include a vehicles array.

Each vehicle requires:

vehicle_year
vehicle_make
vehicle_model
vehicle_type

Supported Vehicle Types

CAR
PICKUP
SUV
VAN
MOTORCYCLE
ATV
BOAT
RV
HEAVY_EQUIPMENT
TRAVEL_TRAILER
LARGE_YACHT
OTHER

Freight Loads (Non-Auto Transport)

If the load is not auto transport, you must send a commodities array instead of vehicles.

Refer to the full developer documentation for detailed commodity structure.

Trailer Types

Supported values:

OPEN
ENCLOSED
FLATBED
LOWBOY
REEFER
DRY_VAN
DRIVEAWAY
OTHER

Common Use Cases

Capture leads from website quote forms
Sync CRM opportunities into Dispatchable
Automate inbound load creation
Replace manual data entry

Testing Your Integration

We recommend testing using:

Postman
Apidog
Your form provider’s webhook testing tools

Start with the example above and expand as needed.

Common Issues

Missing Vehicles

If load_type = auto_transport and no vehicles are provided, the request will fail.

Invalid API Key

Ensure your API key is copied correctly from your Lead Source settings.

Invalid Enum Values

Fields like trailer_type and vehicle_type must match supported values exactly (case-sensitive).

Need Help?

If you need assistance setting up your integration, contact support or schedule a walkthrough with our team.

Related to