---
title: TriggerRequest schema
description: All fields are optional; an empty body starts a test-mode run with an empty payload.
canonical_url: "https://cascades.crscreditapi.com/docs/api/schemas/TriggerRequest"
doc_version: "1.0.0"
last_updated: "2026-10-09T18:04:24Z"
source: "public/api-docs/v1/swagger.yaml#/components/schemas/TriggerRequest"
---

# TriggerRequest

All fields are optional; an empty body starts a test-mode run with an empty payload.

Defined in [openapi.json](https://cascades.crscreditapi.com/openapi.json#/components/schemas/TriggerRequest) ([YAML](https://cascades.crscreditapi.com/openapi.yaml)).

| Field | Type | Required | Description |
|---|---|---|---|
| `payload` | object | no | The decision input. Put the subject under `applicant`; arbitrary nested fields are allowed and become the execution's `input_context`. Defaults to `{}` when omitted. |
|   `applicant` | ApplicantPayload | no | Free-form applicant data forwarded to the workflow's first node as `context.applicant`. Field names depend on the workflow definition. |
|   `property` | object | no | Optional property / tenancy details (as returned by `listWorkflowTestCases`). |
| `execution_mode` | string | no | `test` uses synthetic vendor data and never bills; `live` requires production access and an active cascade. One of: `"test"`, `"live"`. |
| `external_reference` | string | no | Your correlation id for this run. Echoed on the execution and on every webhook event. |

```json
{
  "payload": {
    "applicant": {
      "first_name": "Jordan",
      "last_name": "Lee",
      "email": "jordan@example.com",
      "ssn": "123-45-6789",
      "dob": "1989-04-12"
    },
    "property": {}
  },
  "execution_mode": "test",
  "external_reference": "rv-app-20491"
}
```

## Sitemap

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