---
title: "Trigger Workflow"
method: POST
path: "/v1/workflows/{id}/trigger"
tags: ["Workflow"]
---

# Trigger Workflow

`POST /v1/workflows/{id}/trigger`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/workflows/{id}/trigger`
- Auth: none declared
- TypeScript: <https://skmtc.dev/usenash/apis/nash-api/docs/v1/workflows/:id/trigger/post.ts> (a function with typed inputs; its response is checked against the schema)

Trigger an active or inactive workflow with optional entity references and input data. Supports sync and async execution modes.

## Path parameters

- `id` string, required

## Request body

- TriggerWorkflowSerializer
  - `jobId` string, nullable: Legacy. Use entity_refs instead.
  - `entityRefs` object, nullable: Entity type to ID mapping. Supported types: order, job, delivery, task, route.
  - `input` object, nullable: Arbitrary JSON payload accessible in workflow templates via {{ trigger_metadata.<key> }}.
  - `sync` boolean: Run the workflow synchronously and return the completed result.

## Other responses

- `422`: Unprocessable Content

## Changes

- **2026-11-03** `e3713837c5c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usenash/apis/nash-api/changes/v1/workflows/:id/trigger/post.md)

---

[API](https://skmtc.dev/usenash/apis/nash-api.md) - [All operations](https://skmtc.dev/usenash/apis/nash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usenash/apis/nash-api/revisions/e3713837c5c9?raw)