Calming Directions Webhook: n8n Workflow for Reflection → JSON

Turn a quick reflection into a calm emotional state (with JSON you can trust)

This n8n workflow accepts a short reflection via a webhook, validates the input, and calls ImageHealthy’s public calming-direction API to return an everyday emotional state, two visual goals, and a structured JSON response—complete with clear validation and upstream-error handling.

What this workflow does

• Receives a POST webhook request containing reflection (or emotion) in the JSON body.
• Validates the input by trimming and enforcing a 1–500 character string constraint.
• Calls the calming-direction API using the validated text via an HTTP Request to ImageHealAI’s recommendation endpoint (public API from imagehealthy.com).
• Returns a stable JSON response on success, including:
  • currentState
  • recommendedGoals
  • a human-readable message
• Handles failures safely:
  • If input is invalid, it returns an INVALID_INPUT error describing the expected request body.
  • If the API fails, it returns an error response that preserves the upstream error message and error code.

Use cases

• Build a “check-in” feature in your app where users submit a short reflection and immediately receive a calming direction.
• Power a wellness dashboard by converting free-text moods into consistent currentState and recommendedGoals outputs.
• Create an internal tool for SaaS operators to test and validate webhook-driven AI recommendations with robust error behavior.

Technical details

• Designed for n8n using built-in nodes: Webhook, Code, If, HTTP Request, and Respond to Webhook (plus a Sticky Note for documentation).
• Setup: publish the workflow, copy the “Receive reflection” Webhook Production URL, and POST JSON containing reflection or emotion.
• If you batch requests, throttle to no more than one request every 500 ms to reduce rate-limit issues.