|
1 | 1 | --- |
2 | | -title: Webhook |
3 | | -description: The Webhook block sends an HTTP POST to an external endpoint, with automatic headers and optional signing. |
| 2 | +title: Outgoing Webhook |
| 3 | +description: The Outgoing Webhook block sends an HTTP POST to an external endpoint, with automatic headers and optional signing. |
4 | 4 | pageType: reference |
5 | 5 | --- |
6 | 6 |
|
7 | 7 | import { Callout } from 'fumadocs-ui/components/callout' |
8 | 8 | import { BlockPreview, WorkflowPreview, WEBHOOK_NOTIFY_WORKFLOW, WEBHOOK_TRIGGER_WORKFLOW } from '@/components/workflow-preview' |
9 | 9 | import { FAQ } from '@/components/ui/faq' |
10 | 10 |
|
11 | | -The Webhook block sends HTTP POST requests to external webhook endpoints with automatic webhook headers and optional HMAC signing. |
| 11 | +The Outgoing Webhook block sends HTTP POST requests to external webhook endpoints with automatic webhook headers and optional HMAC signing. |
12 | 12 |
|
13 | 13 | <BlockPreview type="webhook" /> |
14 | 14 |
|
@@ -77,16 +77,16 @@ Format the result, then POST it to a Slack, Discord, or custom endpoint. |
77 | 77 |
|
78 | 78 | <WorkflowPreview workflow={WEBHOOK_TRIGGER_WORKFLOW} /> |
79 | 79 |
|
80 | | -When the Condition passes, the Webhook starts a process in another system. |
| 80 | +When the Condition passes, the Outgoing Webhook starts a process in another system. |
81 | 81 |
|
82 | 82 | <Callout> |
83 | | -The Webhook block always uses POST. For other HTTP methods or more control, use the [API block](/workflows/blocks/api). |
| 83 | +The Outgoing Webhook block always uses POST. For other HTTP methods or more control, use the [API block](/workflows/blocks/api). |
84 | 84 | </Callout> |
85 | 85 |
|
86 | 86 | <FAQ items={[ |
87 | | - { question: "Can I use HTTP methods other than POST?", answer: "No. The Webhook block always sends POST requests. If you need GET, PUT, DELETE, or PATCH, use the API block instead, which supports all standard HTTP methods." }, |
| 87 | + { question: "Can I use HTTP methods other than POST?", answer: "No. The Outgoing Webhook block always sends POST requests. If you need GET, PUT, DELETE, or PATCH, use the API block instead, which supports all standard HTTP methods." }, |
88 | 88 | { question: "How does HMAC payload signing work?", answer: "When you provide a signing secret, the block generates an HMAC-SHA256 signature of the payload and includes it in the X-Webhook-Signature header in the format t=timestamp,v1=signature. The receiver can verify by computing HMAC-SHA256(secret, \"timestamp.body\") and comparing with the v1 value." }, |
89 | 89 | { question: "What headers are added automatically?", answer: "Every webhook request automatically includes Content-Type (application/json), X-Webhook-Timestamp (Unix timestamp in milliseconds), X-Delivery-ID (unique UUID), and Idempotency-Key (same as X-Delivery-ID for deduplication)." }, |
90 | 90 | { question: "Can custom headers override the automatic ones?", answer: "Yes. Any custom headers you define in the Additional Headers section will override automatic headers that share the same name." }, |
91 | | - { question: "How is the Webhook block different from the API block?", answer: "The Webhook block is purpose-built for webhook delivery: it is POST-only, automatically adds webhook-specific headers (timestamp, delivery ID, idempotency key), and supports optional HMAC signing. The API block is more general-purpose with support for all HTTP methods, query parameters, and configurable retries." }, |
| 91 | + { question: "How is the Outgoing Webhook block different from the API block?", answer: "The Outgoing Webhook block is purpose-built for webhook delivery: it is POST-only, automatically adds webhook-specific headers (timestamp, delivery ID, idempotency key), and supports optional HMAC signing. The API block is more general-purpose with support for all HTTP methods, query parameters, and configurable retries." }, |
92 | 92 | ]} /> |
0 commit comments