Post a Load

post

https://api-int.truckstop.com/loadmanagement/v2/load

Post a load to the loadboard with equipment, stop, rate, and visibility details.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Use this endpoint to post a load to the loadboard with equipment, stop, rate, and visibility details.

After you review the request body and response schema below, use these walkthroughs to see common posting workflows end to end:

Body Params

JSON payload containing the load details

postasuserID

string

(Optional — not recommended)
Unique GUID of the user you wish to post the load as, if different from the authenticated user.

For security reasons, we recommend that each user authenticate individually rather than posting on another user's behalf.

Please note:
• Loads posted using PostAs cannot be filtered by PostAs within Truckstop.com.
• Your integration should always be treated as the source of truth for your loads.

Leave blank to omit this field.

equipmentAttributes

object

commodityId

number

(Optional) Integer ID of the commodity for this load

Commodities List

loadStops

array of objects

length ≥ 2

(Required -- Min 2, max 20) Array of LoadStop objects

loadStops

note

string

Any publically visible loads notes (0-4000 characters)

freightClassId

number

loadNumber

string

Broker specific load identifer

loadTrackingRequired

boolean

Only used for BIN loads, should be false for standard loads

integratorLoadUrl

string | null

Integrator load URL

rateAttributes

object

Posted All In Rate is for standard loads
Tender All In Rate is for BIN loads

customData

array of objects

customData

Dimensional

object

LoadActionAttributes

object

4 - PostOnly is for standard loads
1 - PostOnlineTender is for BIN loads

LoadLabel

string

tenderNotes

string

These notes are not displayed until the load is booked

loadReferenceNumbers

array of strings

loadReferenceNumbers

termsAndConditions

object

isPrivate

boolean

Indicates whether the load is private. When true, the load is visible only to your private carrier network. Optionally, provide leadTimeHours to control how many hours before the earliest pickup time a private load transitions to public.

leadTimeHours

number | null

Number of hours before early pickup that private load transitions to public.

waterfallID

uuid | null

(Optional) Allows brokers to post a private load associated with a waterfall.

What is a waterfall?
More info here.

Providing a waterfallID will automatically set isPrivate to true. If omitted, the load behaves normally.

carrierListIds

array of uuids | null

List of carrier list IDs (each must be a UUID).

carrierListIds

Response

201Successful response