Salla Trigger icon

Salla Trigger

Handle Salla webhooks
Join our community

Overview

This node acts as a webhook trigger for Salla, an e-commerce platform. It listens to various events from Salla such as order creation, product updates, customer changes, payments, shipments, and reviews. When one of the selected events occurs in Salla, the node receives the webhook payload and triggers the workflow.

Common scenarios where this node is beneficial include:

  • Automating order processing when new orders are created or updated.
  • Syncing product or customer data with other systems upon changes.
  • Reacting to payment or shipment status updates.
  • Monitoring coupon usage or special offers applied.
  • Collecting and processing new customer reviews automatically.

For example, you could use this node to start a workflow that sends a notification email whenever an order is shipped or to update your CRM system when a customer is created or updated.

Properties

Name Meaning
Events The specific Salla events to listen to. Options include: Order Created, Order Updated, Order Cancelled, Order Shipped, Order Delivered, Product Created, Product Updated, Product Deleted, Customer Created, Customer Updated, Customer Deleted, Payment Created, Payment Updated, Coupon Used, Special Offer Applied, Shipment Created, Shipment Updated, Review Created, or All Events (listens to all webhook events). This property is required.
Validate Webhook Whether to validate the webhook signature to ensure the request authenticity. If enabled, the node checks the signature header against the webhook secret. Defaults to true.
Webhook Secret The secret key used to validate the webhook signature. If left empty, the node attempts to use the secret stored in credentials. This field is only shown if "Validate Webhook" is enabled.
Return Raw Data Whether to return the raw webhook payload instead of parsed event data. If enabled, the output includes headers, raw body, event type, and timestamp. Defaults to false.

Output

The node outputs JSON data representing the webhook event received from Salla.

  • If Return Raw Data is disabled (default), the output JSON contains:

    • event: The event type string (e.g., "order.created").
    • timestamp: Timestamp of the event from the webhook header or current time.
    • merchantId: Merchant identifier from the webhook header or payload.
    • data: The main event data object from the webhook payload.
    • Additional fields from the webhook payload except merchant_id which is removed.

  • If Return Raw Data is enabled, the output JSON contains:

    • headers: All HTTP headers received with the webhook.
    • body: The full webhook payload as received.
    • event: The event type string.
    • timestamp: Current ISO timestamp.

The node also returns a webhook response with HTTP status 200 and a success message after processing.

Dependencies

  • Requires an active webhook endpoint accessible by Salla to receive events.
  • Optionally requires an API authentication token or OAuth2 credential containing the webhook secret for signature validation.
  • Uses an internal helper function to validate webhook signatures based on the secret and the raw request body.

Troubleshooting

  • Event Ignored: If the node does not trigger, verify that the event sent by Salla matches one of the selected events in the node configuration. Selecting "All Events" disables filtering.
  • Invalid webhook signature: Occurs if signature validation fails. Ensure the webhook secret configured in the node or credentials matches the secret used in Salla's webhook settings. Also, confirm that the raw request body is correctly passed for validation.
  • Missing webhook secret: If "Validate Webhook" is enabled but no secret is provided and none exists in credentials, signature validation will fail.
  • Webhook not triggering: Confirm that the webhook URL generated by n8n is correctly registered in the Salla dashboard and publicly accessible.

Links and References

Discussion