Package Information
Documentation
@chez14/n8n-nodes-saweria
An n8n community node that lets you receive Saweria
donation notifications in your n8n workflows via webhook.
Saweria is an Indonesian donation/tipping platform for content creators and
streamers.
n8n is a fair-code
licensed workflow automation
platform.
Installation
Follow the installation
guide in the
n8n community nodes documentation.
Operations
The Saweria Webhook trigger node listens for incoming donation events from
Saweria. When a donation is received, it emits an item with the following
fields:
| Field | Type | Description |
|---|---|---|
version |
string | Payload format version (e.g. 2022.01) |
created_at |
string | ISO 8601 timestamp of the donation |
id |
string | Unique donation UUID |
type |
string | Event type (donation) |
amount_raw |
number | Donation amount in IDR (Indonesian Rupiah) |
cut |
number | Platform fee deducted |
donator_name |
string | Name provided by the donor |
donator_email |
string | Email provided by the donor |
donator_is_user |
boolean | Whether the donor has a Saweria account |
message |
string | Message from the donor |
Credentials
To enable signature verification (recommended), configure the Saweria
Webhook API credential with your Alert Widget URL:
- Log in to saweria.co and go to Overlay → Alert
Widget - Copy the full Widget URL (e.g.
https://saweria.co/widgets/alert?streamKey=abc123) - Paste it into the Alert Widget URL field in the n8n credential — the
stream key is extracted from the URL automatically
If no credentials are attached to the node, signature verification is skipped
and all incoming POST requests are accepted. This is useful for initial testing
but not recommended for production.
Note: The credential test only verifies that the Saweria server is
reachable. The Streamer Key itself cannot be validated via API — it is a
signing secret used only for HMAC verification.
Compatibility
Tested against n8n version 1.x. Requires n8nNodesApiVersion: 1.
Usage
- Add the Saweria Webhook node to your workflow.
- (Optional) Attach Saweria Webhook API credentials for signature
verification. - Copy the webhook URL shown in the node panel.
- In Saweria, go to Settings → Webhook and paste the URL.
- Activate the workflow.
Signature Verification
Saweria signs each webhook request using HMAC-SHA256. The signature is
computed over the concatenation of:
version + id + amount_raw + donator_name + donator_email
and sent in the Saweria-Callback-Signature header. When credentials are
configured, the node verifies this signature and rejects requests that fail
validation with HTTP 401.
Resources
- n8n community nodes
documentation - Saweria webhook documentation
- Extended webhook
documentation - Node source code
This node was developed with reference to:
- Official Saweria docs: http://saweria.co/docs/webhook
- Community webhook documentation:
https://gitlab.com/chez14/saweria-webhook-documentation
Trademark & Copyright Notice
The Saweria logo used in this package is the copyright of Saweria and was
obtained directly from saweria.co. All rights reserved by
the respective owner. This package is an independent community integration and
is not affiliated with or endorsed by Saweria.