Bill of lading created

Sent when a bill of lading is first attached to a shipment.

EVENTbillOfLading.created

POST to your endpointSigned with HMAC-SHA256Retried for up to 4 days

RequestPOSThttps://your-server.example.com/webhooks/mothership

Content-Type:application/json

X-Mothership-Signature:f31bc80f45d99fdba8301b76566d19e37f2d89705a45cbb768a6a280d605b2c4

X-Mothership-Delivery-Id:3f6c1a9e-8b2d-4c7a-9e15-2d8b7f4a6c01same on every retry

{

: "billOfLading.created",

: {

: "MS123456",

: "billOfLading",

: "https://files.mothership.com/MS123456/billOfLading.pdf",

: "2026-10-15T15:04:05.000Z",

: "2026-10-08T15:03:58.000Z"

: "2026-10-08T15:04:05.000Z",

: 1,

: 16

}

Hover a key to see what it means. Click it to jump to the field.

Sent once, when the shipment's first bill of lading is attached. Every later version sends billOfLading.updated with a new url.

Subscribing

Add billOfLading.created to a configuration's subscribedEvents with Create a webhook configuration or in the dashboard.

data · 5 keys

shipmentIdstring
The shipment's reference number, such as MS123456. Pass it to Get shipment details.
typestring
The kind of document.
billOfLading
urlstring
Where to download the document. Download it when the event arrives. To fetch it later, call List shipment documents for a current URL.
expiresAtstringDeprecated
An ISO 8601 string a year after Mothership built the event. It still goes out on every document event, but it doesn't say when url stops working.
createdAtstring
When the bill of lading was created, as an ISO 8601 string in UTC.

eventTypestring
The event. Always billOfLading.created here. Route on it, and answer 2xx to types you don't handle.
sentAtstring
When Mothership queued the event to send, as an ISO 8601 string in UTC. Every retry and resend carries the same value, so it does not say when this attempt went out.
deliveryAttemptinteger
Which send of this event this is, starting at 1. Resends from the dashboard count too.
pendingRetriesinteger
How many automatic attempts are left if this one fails. 0 on the last one.