---
title: "Load Events"
method: POST
path: "/load-webhooks"
tags: ["Webhooks"]
---

# Load Events

`POST /load-webhooks`

Posts a message when an event about a load is triggered.

The load event payload has a base schema but the details change depending on the event type.
During the onboarding you can let Loadsmart know which events you want to receive. You can also
receive events in more than one URL.

Difference between load and shipment:

Although loads and shipments usually refer to the same thing, Loadsmart handles them
as two slightly different entities. Up to the point when a load is tendered and booked,
the entity in play is a "load". After this load is booked, it becomes a shipment.
From this point on, communication is done with the shipment.

List of event types:
  - load:rejected
  - load:accepted

## Request body

- union
  - object
    - `details` object
      - `shipment` object
        - `id` string, uuid — The shipment identifier
      - `load` object
        - `id` string, uuid — The load identifier received in the /api/v2/loads/tender endpoint
        - `ref_number` string — The load identifier on the customer's side
        - `properties` object — General information about the load. This is an open JSON field that allows passing special properties with meaning on the customer context, such as the order numbers, must_arrive_by_date, and others.
      - `shipper` object
        - `id` string, uuid — The shipper identifier
    - `created_at` string, date-time — The date and time of the event.
    - `type` string — Event type
  - object
    - `details` object
      - `load` object
        - `id` string, uuid — The load identifier received in the /api/v2/loads/tender endpoint
        - `ref_number` string — The load identifier on the customer's side
        - `properties` object — General information about the load. This is an open JSON field that allows passing special properties with meaning on the customer context, such as the order numbers, must_arrive_by_date, and others.
      - `shipper` object
        - `id` string, uuid — The shipper identifier
    - `created_at` string, date-time — The date and time of the event.
    - `type` string — Event type

## Response `200`

Event received

---

[API](https://skmtc.dev/loadsmart/apis/loadsmart-api.md) · [All operations](https://skmtc.dev/loadsmart/apis/loadsmart-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loadsmart/loadsmart-api/revisions/6021c5806fe9/schema)