Required

Load Draft

​

v1 equivalent: loadDraft (flat payload — the data fields below are sent at the top level, without the envelope).

Sent when Augment's load building agent has assembled a load draft and is ready to create a load in the TMS. workflow is LOAD_BUILDING. The envelope loadNumber / customerLoadInternalId are null because the load does not exist in the TMS yet.

Body·

required
application/json

Fields present on every v2 webhook event.

Responses

  • application/json
Request Example for post/LOAD_DRAFT
curl /LOAD_DRAFT \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "01JR7ZC3M8Q9W2D4F6H8K0N2P4",
  "workflow": "LOAD_BUILDING",
  "occurredAt": "2026-07-01T09:00:00Z",
  "loadNumber": null,
  "customerLoadInternalId": null,
  "eventType": "LOAD_DRAFT",
  "data": {
    "loadDraftId": "01JR7ZC3M8Q9W2D4F6H8K0N2P4",
    "referenceNumbers": {
      "customerReferenceNumber": "CUST-REF-12345",
      "bolNumber": "BOL-9988",
      "poNumber": "PO-44521",
      "shipmentNumber": "SHP-2026-0042"
    },
    "customerInformation": {
      "name": "Acme Foods Inc.",
      "contact": {
        "email": "ops@acme-foods.example.com",
        "phone": "+13125550199"
      },
      "address": {
        "name": "Acme HQ",
        "streetAddress": "500 W Madison St",
        "city": "Chicago",
        "state": "IL",
        "zip": "60661",
        "country": "US"
      },
      "shipperId": "SHIPPER-ACME-001",
      "notes": "Call 1 hour before arrival",
      "internalNotes": "Tier 1 customer: escalate any delays"
    },
    "stops": [
      {
        "stopNumber": 1,
        "stopType": "PICKUP",
        "facilityName": "Acme DC - Chicago",
        "facilityCode": "ACM-CHI-01",
        "facilityAddress": {
          "streetAddress": "1200 S Cicero Ave",
          "city": "Chicago",
          "state": "IL",
          "zip": "60623",
          "country": "US"
        },
        "facilityContact": {
          "email": "dock@acme-chi.example.com",
          "phone": "+17735550144"
        },
        "handlingType": "LIVE",
        "appointmentType": "APPOINTMENT",
        "appointmentTime": {
          "start": "2026-07-02T13:00:00Z",
          "end": "2026-07-02T15:00:00Z",
          "timezone": "America/Chicago"
        },
        "driverInstructions": "Check in at guard shack with BOL"
      },
      {
        "stopNumber": 2,
        "stopType": "DELIVERY",
        "facilityName": "Midwest Grocers DC",
        "facilityAddress": {
          "streetAddress": "8400 Industrial Pkwy",
          "city": "Detroit",
          "state": "MI",
          "zip": "48210",
          "country": "US"
        },
        "handlingType": "DROP_TRAILER",
        "appointmentType": "FIRST_COME_FIRST_SERVE",
        "dropTime": {
          "start": "2026-07-03T10:00:00Z",
          "end": "2026-07-03T22:00:00Z",
          "timezone": "America/Detroit"
        }
      }
    ],
    "loadDetails": {
      "handlingUnit": {
        "unitType": "PALLET",
        "unitCount": "24"
      },
      "commodity": "Mixed frozen goods",
      "weight": {
        "value": "42000",
        "unit": "LBS"
      },
      "dimensions": {
        "length": "48",
        "lengthUnit": "IN",
        "width": "40",
        "widthUnit": "IN",
        "height": "60",
        "heightUnit": "IN"
      },
      "cargoCharacteristics": {
        "stackable": false,
        "hazmat": false,
        "perishable": true
      },
      "cargoItems": [
        {
          "handlingUnit": {
            "unitType": "PALLET",
            "unitCount": "14"
          },
          "packagingUnit": {
            "unitType": "CARTON",
            "unitCount": "560"
          },
          "commodity": "Frozen poultry",
          "description": "Boxed frozen poultry, keep at -10F",
          "dimensions": {
            "length": "48",
            "lengthUnit": "IN",
            "width": "40",
            "widthUnit": "IN",
            "height": "60",
            "heightUnit": "IN"
          },
          "weight": {
            "value": "26000",
            "unit": "LBS"
          },
          "valueAmount": {
            "value": "48000",
            "unit": "USD"
          },
          "cargoCharacteristics": {
            "stackable": false,
            "hazmat": false,
            "perishable": true
          }
        },
        {
          "handlingUnit": {
            "unitType": "PALLET",
            "unitCount": "10"
          },
          "packagingUnit": {
            "unitType": "CARTON",
            "unitCount": "400"
          },
          "commodity": "Frozen vegetables",
          "description": "Mixed vegetable cartons",
          "dimensions": {
            "length": "48",
            "lengthUnit": "IN",
            "width": "40",
            "widthUnit": "IN",
            "height": "48",
            "heightUnit": "IN"
          },
          "weight": {
            "value": "16000",
            "unit": "LBS"
          },
          "valueAmount": {
            "value": "12000",
            "unit": "USD"
          },
          "cargoCharacteristics": {
            "stackable": true,
            "hazmat": false,
            "perishable": true
          }
        }
      ]
    },
    "loadRequirements": {
      "mode": "FTL",
      "loadType": "SPOT",
      "equipment": {
        "equipmentType": "REEFER",
        "size": "53",
        "unit": "FT"
      },
      "temperatureRequirement": {
        "required": true,
        "hasBulkhead": false,
        "zones": [
          {
            "zoneId": "Z1",
            "minTemp": {
              "value": -10,
              "unit": "F"
            },
            "maxTemp": {
              "value": 0,
              "unit": "F"
            }
          }
        ]
      },
      "additionalRequiredServices": [
        "TEAM_DRIVER"
      ]
    },
    "rates": {
      "baseRate": "1850.00",
      "lineHaul": "1700.00",
      "accessorials": [
        {
          "type": "FUEL_SURCHARGE",
          "rate": "150.00"
        }
      ],
      "totalRate": "1850.00",
      "collectionMethod": "PrePaid"
    },
    "documentDates": [
      "2026-07-01"
    ]
  }
}'

{
  "loadNum": "LOAD-12345",
  "message": "Load created successfully"
}

Load created successfully

Previous
Upload Document
Next
Capacity Sourcing