Human Assistance Requested
v1 equivalent: none. v2 only.
Sent when an Augment agent hands a load off to a human. contact is the person at your brokerage the agent routed the request to, so you can surface the handoff to the right queue or rep.
reasonCode says why the agent could not continue on its own.
Fields present on every v2 webhook event.
- Type: string | nullcustomer
Load Internal Id requiredYour internal load ID, if provided during load creation
- Type: object ·datarequired
Human assistance request data payload.
- enumevent
Type const:HUMAN_ASSISTANCE_REQUESTEDrequiredEvent name for a human-assistance request.
values- H
U M A N _ A S S I S T A N C E _ R E Q U E S T E D
- Type: stringidrequired
Unique event identifier (ULID)
- Type: string | nullload
Number requiredYour load reference number
- Type: string Format: date-timeoccurred
At requiredWhen the underlying activity occurred (ISO 8601)
- Type: string | null enumworkflowrequired
The Augment workflow that produced this event, or
nullwhen 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- T
R A C K _ A N D _ T R A C E - C
A R R I E R _ S U P P O R T - P
O D _ C O L L E C T I O N - L
O A D _ B U I L D I N G - C
A R R I E R _ S E L E C T I O N - S
C H E D U L I N G - C
U S T O M E R _ S U P P O R T - null
- 200
Event acknowledged
curl /HUMAN_ASSISTANCE_REQUESTED \
--request POST \
--header 'Content-Type: application/json' \
--data '{
"id": "evt_01HZXK9P7QM3N8YV4TBWJC2RDQ",
"workflow": "TRACK_AND_TRACE",
"occurredAt": "2026-05-13T12:34:56Z",
"loadNumber": "LOAD-456",
"customerLoadInternalId": "INT-789",
"eventType": "HUMAN_ASSISTANCE_REQUESTED",
"data": {
"reasonCode": "INSUFFICIENT_INFORMATION",
"contact": {
"name": "Sam Rep",
"externalId": "REP-123",
"email": "sam@brokerage.example",
"phone": "+15559876543",
"phoneExtension": null
}
}
}'