Skip to content

Create a load posting

Request

Security
OrgTokenBearer
Bodyapplication/jsonrequired
dateAvailstring, (date-time), non-emptyrequired

Load available date/time in ISO 8601 UTC format (e.g. 2026-07-01T00:00:00Z). Non-UTC values are coerced to UTC.

Example:"2026-07-20T08:00:00Z"
srceCitystring, [ 0 .. 50 ] charactersrequired

Source city name. Must match a known city (see city lookup) together with SrceSt.

Example:"Brampton"
srceStstring, = 2 charactersrequired

Source state/province code (2 letters, e.g. "ON", "TX").

Example:"ON"
srceRadiusinteger, (int32), [ 50 .. 200 ]

Search radius in miles around the source city (50–200).

Example:200
destCitystring, [ 0 .. 50 ] charactersrequired

Destination city name. Must match a known city (see city lookup) together with DestSt.

Example:"Surrey"
destStstring, = 2 charactersrequired

Destination state/province code (2 letters, e.g. "ON", "TX").

Example:"BC"
destRadiusinteger, (int32), [ 50 .. 200 ]

Search radius in miles around the destination city (50–200).

Example:200
vehicleSizestring, [ 0 .. 10 ] charactersrequired

Single-letter vehicle size code — see GET /v2/reference/vehicle-sizes (e.g. "T" for TL).

Example:"T"
vehicleTypestring, [ 0 .. 50 ] characters^[VvRrKkFfSsDdTtCcUuHhLlOoNnPpIiEe]+$required

One or more single-letter vehicle type codes concatenated together — see GET /v2/reference/vehicle-types (e.g. "VR" for Van + Reefer).

Example:"VR"
contactEmailstring or null, (email)^[^@]+@[^@]+$

Contact email for this posting. Optional — defaults to your account's own email when omitted. Does not have to match the authenticated account if supplied.

Example:"dispatch@example.com"
contactPhonestring or null, [ 0 .. 15 ] characters

Contact phone for this posting. Optional — defaults to your account's own phone when omitted.

Example:null
commentstring or null, [ 0 .. 180 ] characters

Free-text comment shown alongside the posting (max 180 characters).

Example:"No tarps"
postingAttribstring or null

One or more single-letter vehicle attribute codes concatenated together — see GET /v2/reference/vehicle-attributes (e.g. "AZ" for Air Ride + Hazmat).

Example:"AZ"
lengthinteger or null, (int32)

Load length.

Example:53
weightinteger or null, (int32)

Load weight.

Example:45000
ratenumber or null

Rate amount. Brokers: total trip cost. Carriers: per-mile rate.

Example:2.15
currencyinteger or null

Currency code: 0 = USD, 1 = CAD.

Enum:01
Example:0
curl -i -X POST \
  https://azuatgateway.loadlink.ca/freight-matching/v2/postings/loads \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "dateAvail": "2026-07-20T08:00:00Z",
    "srceCity": "Brampton",
    "srceSt": "ON",
    "srceRadius": 200,
    "destCity": "Surrey",
    "destSt": "BC",
    "destRadius": 200,
    "vehicleSize": "T",
    "vehicleType": "VR",
    "contactEmail": "dispatch@example.com",
    "contactPhone": null,
    "comment": "No tarps",
    "postingAttrib": "AZ",
    "length": 53,
    "weight": 45000,
    "rate": 2.15,
    "currency": 0
  }'

Responses

Posting created

Bodyapplication/json
tokeninteger, (int32)

Unique identifier for the newly created posting. Use this same value as the {token} in GET /v2/leads/equipment/{token} to retrieve leads for this posting, and in GET/DELETE /v2/postings/equipment/{token} to look up or remove it.

messagestring

Human-readable confirmation message.

createdAtstring, (date-time)

Date/time the posting was created, in UTC.

Response
{ "token": 123456, "message": "Load posting created successfully", "createdAt": "2026-07-15T10:30:00Z" }