# WebHookDelivery

One delivery of a web hook: a call Maitento has made, or will make, to the registration's URL. Delivered entries are kept for 24 hours and permanent failures for 7 days.

**Kind:** an object, used in responses.

## Fields

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `id` | `uuid` | The delivery's id. |
| `associatedId` | `uuid` | The id of the run or file the delivery reports on. |
| `lastAttemptTime` | `datetime \| null` | When the last attempt was made, in UTC; null before the first. |
| `nextAttemptTime` | `datetime` | When the next attempt is due, in UTC. A failed attempt is retried with a growing delay. |
| `isSent` | `boolean` | Whether the delivery succeeded. |
| `numberAttempts` | `integer` | How many attempts have been made. |
| `failureDetails` | `string \| null` | Why the last attempt failed: the error message only, at most 2,000 characters. Null when it didn't fail. |
| `isPermanentFailure` | `boolean` | Whether Maitento has given up on the delivery after repeated failures. It won't be retried. |
| `correlationId` | `string \| null` | An id that traces the delivery through Maitento. Quote it when asking for help with a delivery. |
| `dateCreated` | `datetime` | When the delivery was queued, in UTC. |

## Example

```json
{
  "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "associatedId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "lastAttemptTime": "2026-10-26T12:00:00.0000000Z",
  "nextAttemptTime": "2026-10-26T12:00:00.0000000Z",
  "isSent": false,
  "numberAttempts": 0,
  "failureDetails": "...",
  "isPermanentFailure": false,
  "correlationId": "...",
  "dateCreated": "2026-10-26T12:00:00.0000000Z"
}
```

## Where it's used

- [`webhooks.deliveries`](https://docs.maitento.com/reference/api/webhooks.md) (`GET /web-hooks/by-id/{id}/deliveries`)