RedStage Trigger

Handle RedStage events via webhooks

Overview

The RedStage Trigger node is designed to handle incoming webhook events from the RedStage platform within n8n workflows. It allows users to subscribe to a variety of event types (such as order updates, delivery status changes, product modifications, etc.) and triggers workflow execution when those events occur. This node is particularly useful for automating processes in response to real-time changes in your RedStage environment, such as updating inventory, notifying customers, or syncing data with other systems.

Practical examples:

Automatically update your CRM when an order is completed or canceled.
Notify warehouse staff when a new delivery is created or processed.
Sync product updates between RedStage and external e-commerce platforms.

Properties

Name	Type	Meaning
Events	multiOptions	Specifies which RedStage events will trigger this workflow. You can select one or multiple event types.

Available Event Options:

- (All events)
On Delivery Accepted
On Delivery Canceled
On Delivery Committed
On Delivery Created
On Delivery Exception
On Delivery Label Created
On Delivery Label Voided
On Delivery Processed
On Delivery Putaway
On Delivery Status_changed
On Import Completed
On Import Created
On Inventory Adjusted
On Manifest Loaded
On Manifest Sealed
On Order Address Changed
On Order Address Validation Failed
On Order Canceled
On Order Completed
On Order Created
On Order Holded
On Order Status Changed
On Product Created
On Product Deleted
On Product Media Created
On Product Media Deleted
On Product Media Updated
On Product Sku_changed
On Product Updated
On Shipment Labels Voided
On Shipment Packed
On Shipment Reverted

Output

The node outputs the JSON body received from the RedStage webhook as the json field in the output item.
If HMAC verification fails, the output will be:
```
[
  {
    "error": "HMAC not same"
  }
]
```
Otherwise, the output will mirror the structure of the incoming webhook payload, which depends on the specific event type triggered.

Note: This node does not output binary data.

Dependencies

External Service: Requires access to the RedStage API/webhook system.
API Credentials: Needs a credential named redStageApi configured in n8n.
Environment: No special environment variables are required beyond standard n8n setup.

Troubleshooting

Common Issues:

HMAC Verification Failure:
- Error: "error": "HMAC not same"
- Cause: The secret used to sign the webhook payload does not match the one stored in the node's static data. This could happen if the webhook was manually changed or credentials were rotated.
- Solution: Recreate the webhook via the node or ensure the correct secret is set in both RedStage and n8n.
Webhook Not Triggering:
- Cause: The selected events may not be firing, or the webhook URL is incorrect.
- Solution: Double-check the event selection and verify that the webhook URL registered in RedStage matches the one provided by n8n.
Credential Errors:
- Cause: Missing or invalid redStageApi credentials.
- Solution: Ensure valid credentials are configured in n8n under the name redStageApi.
Webhook Creation/Deletion Errors:
- Error messages related to "Error when create webhook" or "Error when delete webhook".
- Solution: Check API connectivity, permissions, and that the RedStage account has rights to manage webhooks.

Links and References

n8n Documentation: Webhook Triggers
RedStage Platform (for more information about available events and API documentation)