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 null, and the envelope loadNumber / customerLoadInternalId are null because the load does not exist in the TMS yet.

Body·
required
application/json

Common envelope fields shared by v2 webhook events. Each concrete event schema adds its own eventType and typed data payload.

    • 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

      values
      • TRACK_AND_TRACE
      • CARRIER_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": null,
  "occurredAt": "2026-07-01T09:00:00Z",
  "loadNumber": null,
  "customerLoadInternalId": null,
  "eventType": "LOAD_DRAFT",
  "data": {
    "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": "Frozen poultry",
      "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
      }
    },
    "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