---
title: "Trigger a Webhook (PUT)"
method: PUT
path: "/v1/webhooks/{path}"
tags: ["Webhooks API"]
---

# Trigger a Webhook (PUT)

`PUT /v1/webhooks/{path}`

Receives a webhook callback via HTTP PUT and triggers the associated workflow execution. The path is dynamically resolved against the webhook registry — each workflow can register its own webhook path. The runtime accepts GET, POST, PUT, PATCH, and DELETE on this route, as well as nested paths with multiple segments.

## Path parameters

- `path` string, required

## Headers

- `Idempotency-Key` string
- `X-Webhook-Token` string

## Request body

- object — Webhook payload from the external system. Flowker injects webhook metadata (`_webhook` key with method, path, headers, query params, and remote IP) before passing to the workflow.

## Response `200`

Workflow execution completed synchronously (terminal state).

- ExecutionCreateOutput
  - `executionId` string, uuid — Unique identifier of the execution.
  - `startedAt` string, date-time — Timestamp when the execution started.
  - `status` string — Initial status of the execution (always `pending`).
  - `workflowId` string, uuid — ID of the workflow being executed.

## Other responses

- `201` — Workflow execution created and running asynchronously.
- `400` — Indicates that the request body is malformed or could not be parsed.
- `401` — Unauthorized. Either the API key is invalid or the `X-Webhook-Token` header is missing or incorrect.
- `404` — No webhook registered for this path and HTTP method, or the associated workflow was not found.
- `409` — Duplicate idempotency key — this webhook delivery was already processed.
- `413` — Webhook payload exceeds the 1 MB size limit.
- `422` — The associated workflow is not in an active state and cannot be executed.
- `500` — Indicates an unexpected internal error. If this persists, please contact support.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)