Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
231 changes: 0 additions & 231 deletions apps/docs/content/docs/de/tools/generic_webhook.mdx

This file was deleted.

2 changes: 1 addition & 1 deletion apps/docs/content/docs/de/triggers/webhook.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Der generische Webhook-Block erstellt einen flexiblen Endpunkt, der beliebige Pa

<div className="flex justify-center">
<Image
src="/static/blocks/webhook.png"
src="/static/blocks/webhook-trigger.png"
alt="Generische Webhook-Konfiguration"
width={500}
height={400}
Expand Down
1 change: 1 addition & 0 deletions apps/docs/content/docs/en/blocks/meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@
"router",
"variables",
"wait",
"webhook",
"workflow"
]
}
87 changes: 87 additions & 0 deletions apps/docs/content/docs/en/blocks/webhook.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
---
title: Webhook
---

import { Callout } from 'fumadocs-ui/components/callout'
import { Image } from '@/components/ui/image'

The Webhook block sends HTTP POST requests to external webhook endpoints with automatic webhook headers and optional HMAC signing.

<div className="flex justify-center">
<Image
src="/static/blocks/webhook.png"
alt="Webhook Block"
width={500}
height={400}
className="my-6"
/>
</div>

## Configuration

### Webhook URL

The destination endpoint for your webhook request. Supports both static URLs and dynamic values from other blocks.

### Payload

JSON data to send in the request body. Use the AI wand to generate payloads or reference workflow variables:

```json
{
"event": "workflow.completed",
"data": {
"result": "<agent.content>",
"timestamp": "<function.result>"
}
}
```

### Signing Secret

Optional secret for HMAC-SHA256 payload signing. When provided, adds an `X-Webhook-Signature` header:

```
X-Webhook-Signature: t=1704067200000,v1=5d41402abc4b2a76b9719d911017c592...
```

To verify signatures, compute `HMAC-SHA256(secret, "${timestamp}.${body}")` and compare with the `v1` value.

### Additional Headers

Custom key-value headers to include with the request. These override any automatic headers with the same name.

## Automatic Headers

Every request includes these headers automatically:

| Header | Description |
|--------|-------------|
| `Content-Type` | `application/json` |
| `X-Webhook-Timestamp` | Unix timestamp in milliseconds |
| `X-Delivery-ID` | Unique UUID for this delivery |
| `Idempotency-Key` | Same as `X-Delivery-ID` for deduplication |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| `data` | json | Response body from the endpoint |
| `status` | number | HTTP status code |
| `headers` | object | Response headers |

## Example Use Cases

**Notify external services** - Send workflow results to Slack, Discord, or custom endpoints
```
Agent → Function (format) → Webhook (notify)
```

**Trigger external workflows** - Start processes in other systems when conditions are met
```
Condition (check) → Webhook (trigger) → Response
```

<Callout>
The Webhook block always uses POST. For other HTTP methods or more control, use the [API block](/blocks/api).
</Callout>
2 changes: 1 addition & 1 deletion apps/docs/content/docs/en/triggers/webhook.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ The Generic Webhook block creates a flexible endpoint that can receive any paylo

<div className="flex justify-center">
<Image
src="/static/blocks/webhook.png"
src="/static/blocks/webhook-trigger.png"
alt="Generic Webhook Configuration"
width={500}
height={400}
Expand Down
Loading