# Proof of delivery created

> Sent when a proof of delivery is first attached.

`eventType` is `proofOfDelivery.created`.

Sent once, when the shipment's first proof of delivery is attached. Later versions send [`proofOfDelivery.updated`](https://docs.mothership.com/reference/proof-of-delivery-updated).

## Subscribing

Add `proofOfDelivery.created` to a configuration's `subscribedEvents`. It needs no extra permission.

## Event data

- `shipmentId` (string): The shipment's reference number, such as `MS123456`. Pass it to Get shipment details.
- `type` (string): The kind of document. One of: `proofOfDelivery`.
- `url` (string): Where to download the document. Download it when the event arrives. To fetch it later, call List shipment documents for a current URL.
- `expiresAt` (string, deprecated): An ISO 8601 string a month after Mothership built the event. It still goes out on every document event, but it doesn't say when `url` stops working.
- `createdAt` (integer): When the document was created, in milliseconds since the Unix epoch, such as `1791471838000`. Unlike every other timestamp in a webhook, this one is a number. On the rare document with no creation time it is an ISO 8601 string instead, so accept both.

## Envelope

Mothership sends a `POST` with this JSON body. The envelope is the same on every event, and `data` holds the keys above.

- `eventType` (string): The event. Always `proofOfDelivery.created` here. Route on it, and answer `2xx` to types you don't handle.
- `sentAt` (string): 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.
- `deliveryAttempt` (integer): Which send of this event this is, starting at `1`. Resends from the dashboard count too.
- `pendingRetries` (integer): How many automatic attempts are left if this one fails. `0` on the last one.

## Example request

```json Example body
{
  "eventType": "proofOfDelivery.created",
  "data": {
    "shipmentId": "MS123456",
    "type": "proofOfDelivery",
    "url": "https://files.mothership.com/MS123456/proofOfDelivery.pdf",
    "expiresAt": "2026-10-15T15:04:05.000Z",
    "createdAt": 1791471838000
  },
  "sentAt": "2026-10-08T15:04:05.000Z",
  "deliveryAttempt": 1,
  "pendingRetries": 16
}
```