---
title: "Receive Workflow Webhook"
method: PUT
path: "/v3/webhooks/workflows/{webhook_id}"
tags: ["v3", "webhooks", "http-trigger"]
---

# Receive Workflow Webhook

`PUT /v3/webhooks/workflows/{webhook_id}`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v3/webhooks/workflows/{webhook_id}`
- Auth: none declared

Receive an inbound HTTP request to trigger a v3 workflow.

The ``webhook_id`` maps to a deployed workflow with an ``http-trigger``
node.  The request body is parsed as JSON and forwarded to the workflow
as the trigger's output data.

Returns **202 Accepted** immediately; the workflow runs asynchronously.

## Path parameters

- `webhook_id` string, required

## Headers

- `X-API-Key` string, nullable: API key for webhook authentication

## Response `202`

Successful Response

- HttpTriggerResponse
  - `execution_id` string, required
  - `status` string, required
  - `temporal_workflow_id` string, nullable

## Other responses

- `422`: Validation Error

---

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