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.

    • customerLoadInternalId
      Type: string | null
      required

      Your internal load ID, if provided during load creation

    • data
      Type: object ·
      required

      Load draft data payload.

    • eventType
      enum
      const:  
      LOAD_DRAFT
      required

      Event name for an assembled load draft.

      values
      • LOAD_DRAFT
    • id
      Type: string
      required

      Unique event identifier (ULID)

    • loadNumber
      Type: string | null
      required

      Your load reference number

    • occurredAt
      Type: string Format: date-time
      required

      When the underlying activity occurred (ISO 8601)

    • workflow
      Type: string | null enum
      required

      The Augment workflow that produced this event, or null when no single workflow can be attributed. New values may be added over time, so treat this as an open set rather than a fixed list.

      values
      • TRACK_AND_TRACE
      • CARRIER_SUPPORT
      • POD_COLLECTION
      • LOAD_BUILDING
      • CARRIER_SELECTION
      • SCHEDULING
      • CUSTOMER_SUPPORT
      • null
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