Skip to content

Commit 5145ce1

Browse files
authored
improvement(response): removed nested response block output, add docs for webhook block, styling improvements for subblocks (#2700)
* improvement(response): removed nested response block output, add docs for webhook block, styling improvements for subblocks * remove outdated block docs * updated docs * remove outdated tests
1 parent e5bd5e4 commit 5145ce1

File tree

28 files changed

+792
-1418
lines changed

28 files changed

+792
-1418
lines changed

apps/docs/content/docs/de/tools/generic_webhook.mdx

Lines changed: 0 additions & 231 deletions
This file was deleted.

apps/docs/content/docs/de/triggers/webhook.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Der generische Webhook-Block erstellt einen flexiblen Endpunkt, der beliebige Pa
1515

1616
<div className="flex justify-center">
1717
<Image
18-
src="/static/blocks/webhook.png"
18+
src="/static/blocks/webhook-trigger.png"
1919
alt="Generische Webhook-Konfiguration"
2020
width={500}
2121
height={400}

apps/docs/content/docs/en/blocks/meta.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@
1414
"router",
1515
"variables",
1616
"wait",
17+
"webhook",
1718
"workflow"
1819
]
1920
}
Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
title: Webhook
3+
---
4+
5+
import { Callout } from 'fumadocs-ui/components/callout'
6+
import { Image } from '@/components/ui/image'
7+
8+
The Webhook block sends HTTP POST requests to external webhook endpoints with automatic webhook headers and optional HMAC signing.
9+
10+
<div className="flex justify-center">
11+
<Image
12+
src="/static/blocks/webhook.png"
13+
alt="Webhook Block"
14+
width={500}
15+
height={400}
16+
className="my-6"
17+
/>
18+
</div>
19+
20+
## Configuration
21+
22+
### Webhook URL
23+
24+
The destination endpoint for your webhook request. Supports both static URLs and dynamic values from other blocks.
25+
26+
### Payload
27+
28+
JSON data to send in the request body. Use the AI wand to generate payloads or reference workflow variables:
29+
30+
```json
31+
{
32+
"event": "workflow.completed",
33+
"data": {
34+
"result": "<agent.content>",
35+
"timestamp": "<function.result>"
36+
}
37+
}
38+
```
39+
40+
### Signing Secret
41+
42+
Optional secret for HMAC-SHA256 payload signing. When provided, adds an `X-Webhook-Signature` header:
43+
44+
```
45+
X-Webhook-Signature: t=1704067200000,v1=5d41402abc4b2a76b9719d911017c592...
46+
```
47+
48+
To verify signatures, compute `HMAC-SHA256(secret, "${timestamp}.${body}")` and compare with the `v1` value.
49+
50+
### Additional Headers
51+
52+
Custom key-value headers to include with the request. These override any automatic headers with the same name.
53+
54+
## Automatic Headers
55+
56+
Every request includes these headers automatically:
57+
58+
| Header | Description |
59+
|--------|-------------|
60+
| `Content-Type` | `application/json` |
61+
| `X-Webhook-Timestamp` | Unix timestamp in milliseconds |
62+
| `X-Delivery-ID` | Unique UUID for this delivery |
63+
| `Idempotency-Key` | Same as `X-Delivery-ID` for deduplication |
64+
65+
## Outputs
66+
67+
| Output | Type | Description |
68+
|--------|------|-------------|
69+
| `data` | json | Response body from the endpoint |
70+
| `status` | number | HTTP status code |
71+
| `headers` | object | Response headers |
72+
73+
## Example Use Cases
74+
75+
**Notify external services** - Send workflow results to Slack, Discord, or custom endpoints
76+
```
77+
Agent → Function (format) → Webhook (notify)
78+
```
79+
80+
**Trigger external workflows** - Start processes in other systems when conditions are met
81+
```
82+
Condition (check) → Webhook (trigger) → Response
83+
```
84+
85+
<Callout>
86+
The Webhook block always uses POST. For other HTTP methods or more control, use the [API block](/blocks/api).
87+
</Callout>

apps/docs/content/docs/en/triggers/webhook.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ The Generic Webhook block creates a flexible endpoint that can receive any paylo
1515

1616
<div className="flex justify-center">
1717
<Image
18-
src="/static/blocks/webhook.png"
18+
src="/static/blocks/webhook-trigger.png"
1919
alt="Generic Webhook Configuration"
2020
width={500}
2121
height={400}

0 commit comments

Comments
 (0)