---
title: "Create Workflow Trigger"
method: POST
path: "/v1/workflows/{workflow_id}/triggers"
tags: ["V1 - Triggers"]
---

# Create Workflow Trigger

`POST /v1/workflows/{workflow_id}/triggers`

## Request

- Base URL: `https://api.app.noxus.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.app.noxus.ai/v1/workflows/{workflow_id}/triggers`
- Auth: API key in header `X-API-Key`

Create a trigger on a workflow. The trigger is attributed to this API key.

## Path parameters

- `workflow_id` string, required

## Request body

- CreateTriggerRequest
  - `definition` object, required
  - `name` string, nullable
  - `workflow_version_id` string, uuid, nullable

## Response `200`

Successful Response

- Trigger
  - `id` string, uuid, required
  - `group_id` string, uuid, required
  - `workflow_id` string, uuid, required
  - `name` string, nullable
  - `definition` object, required
  - `routing_key` string, required
  - `workflow_version_id` string, uuid, nullable
  - `last_run_at` string, date-time, nullable
  - `last_fired_at` string, date-time, nullable
  - `last_error` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/noxus/apis/noxus-backend.md) - [All operations](https://skmtc.dev/noxus/apis/noxus-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/noxus/apis/noxus-backend/revisions/0e37810b7ad5?raw)
