---
title: "Create Workflow"
method: POST
path: "/workflows"
tags: ["workflows", "alerts"]
---

# Create Workflow

`POST /workflows`

Create or update a workflow

## Response `201`

Successful Response

- WorkflowCreateOrUpdateDTO
  - `workflow_id` string, required
  - `status` 'created' | 'updated', required
  - `revision` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/keephq/apis/keep-api.md) · [All operations](https://skmtc.net/keephq/apis/keep-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keephq/keep-api/revisions/bb4a0896091f/schema)