---
title: adverse_action.failed webhook
description: Emitted when sending a notice raised an error. For the post-adverse stage this fires only after the retry budget is exhausted (see…
canonical_url: "https://cascades.crscreditapi.com/docs/api/webhooks/adverse_action.failed"
doc_version: "1.0.0"
last_updated: "2026-10-09T18:04:24Z"
source: "public/api-docs/v1/swagger.yaml#/x-webhooks/adverse_action.failed"
---

# `adverse_action.failed`

A notice could not be delivered

Emitted when sending a notice raised an error. For the post-adverse
stage this fires only after the retry budget is exhausted (see
`adverse_action.retry_scheduled` for the intermediate attempts); the
execution then fails.


Payload schema: [openapi.json](https://cascades.crscreditapi.com/openapi.json#/x-webhooks/adverse_action.failed) ([YAML](https://cascades.crscreditapi.com/openapi.yaml)). Deliveries are signed; see [Webhook events](https://cascades.crscreditapi.com/docs/api/webhooks.md) for the `X-Cascades-Signature` scheme.

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `event` | string | yes |  One of: `"adverse_action.failed"`. |
| `created_at` | string (date-time) | yes |  |
| `data` | object | yes |  |
|   `workflow_execution_id` | integer | yes |  |
|   `workflow_id` | integer | yes |  |
|   `node_id` | string | yes |  |
|   `external_reference` | string | no |  |
|   `flow` | string | yes |  |
|   `notice_stage` | string | yes |  One of: `"pre_adverse"`, `"post_adverse"`, `"final"`. |
|   `error` | string | yes | Human-readable delivery error. |
|   `failed_at` | string (date-time) | no |  |
|   `attempt` | integer | no | `post_adverse` only: the attempt number that exhausted the retry budget. |
|   `status` | string | yes |  One of: `"failed"`. |

```json
{
  "id": "3e1f0a9b-8c7d-4e6f-5a4b-2c1d0e9f8a7b",
  "event": "adverse_action.failed",
  "created_at": "2026-09-09T14:08:12Z",
  "data": {
    "workflow_execution_id": 1845,
    "workflow_id": 27,
    "node_id": "step_adverse_action",
    "flow": "tenant_screening",
    "notice_stage": "final",
    "error": "Failed to send adverse action notice to jordan@example.com: SMTP 550 mailbox unavailable",
    "failed_at": "2026-09-09T14:08:11Z",
    "status": "failed"
  }
}
```

## Sitemap

See the full [sitemap](https://cascades.crscreditapi.com/sitemap.md) for all pages.