Overview

This node acts as a webhook trigger for AfterShip events. It listens for incoming HTTP POST requests from AfterShip, verifies the authenticity of the webhook payload using HMAC SHA256 signature verification with a secret key, and then outputs the event data for further workflow processing. This node is useful for automating workflows based on shipment tracking updates or other AfterShip events.

Use Case Examples

1. Automatically update order status in your system when AfterShip sends a shipment update.
2. Trigger notifications or alerts when a shipment status changes via AfterShip webhook.

Output

JSON

• body - The JSON payload received from the AfterShip webhook containing event data

Dependencies

• Requires an API key credential for AfterShip with a webhook secret used for HMAC verification.

Troubleshooting

• If the webhook payload signature verification fails, the node outputs no data. Ensure the webhook secret configured in AfterShip matches the secret used in the node credentials.
• Common error is missing or incorrect 'aftership-hmac-sha256' header which causes verification failure. Verify that AfterShip sends the correct header.
• Ensure the node is properly set up to receive POST requests at the configured webhook path.

Links

• AfterShip Webhooks Documentation - Official documentation on AfterShip webhook setup and payloads.