---
title: "Trigger Workflow Run"
method: POST
path: "/v2/trigger/{workflowUrl}"
tags: ["Runs"]
---

# Trigger Workflow Run

`POST /v2/trigger/{workflowUrl}`

## Request

- Base URL: `https://qstash-eu-central-1.upstash.io`
- URL: `https://qstash-eu-central-1.upstash.io/v2/trigger/{workflowUrl}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `qstash_token`
- TypeScript: <https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/docs/v2/trigger/:workflowUrl/post.ts> (a function with typed inputs; its response is checked against the schema)

Start a new workflow run.

## Path parameters

- `workflowUrl` string, required

## Headers

- `Upstash-Workflow-RunId` string
- `Upstash-Forward-*` string
- `Upstash-Retries` integer
- `Upstash-Delay` string
- `Upstash-Not-Before` integer
- `Upstash-Label` string
- `Upstash-Flow-Control-Key` string
- `Upstash-Flow-Control-Value` string
- `Upstash-Failure-Callback` string
- `Upstash-Failure-Callback-Forward-*` string
- `Upstash-Retry-Delay` string

## Request body

- object

## Response `200`

Workflow triggered successfully

- object
  - `workflowRunId` string: The ID of the triggered workflow run.
  - `workflowCreatedAt` number: The timestamp when the workflow run was created.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api.md) - [All operations](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/revisions/251bee05a7ec?raw)