Skip to main content

Creating Your First Workflow

This guide walks you through creating a workflow that receives content via a webhook, sends it to a human reviewer for approval, and returns the decision. You will have a working workflow in under 10 minutes.
By the end of this guide, you will have an active workflow with a webhook URL that you can trigger from any application, integration, or cURL command.

Prerequisites

Before you begin, ensure you have:

Generate API Key

If you plan to trigger the workflow programmatically, generate an API key first.

Step 1: Create the Workflow

1

Open the Dashboard

Navigate to my.hitl.sh and sign in.
2

Click New Workflow

In the sidebar, click Workflows, then click the New Workflow button. Give it a name like “Content Moderation” and an optional description.
3

Open the Designer

You are now in the workflow designer. The canvas shows a Trigger node already placed — this is the entry point for your workflow.

Step 2: Add a Human Review Node

1

Open the Node Palette

Click the + button on the canvas or drag from the node palette on the left.
2

Select Human Review

Choose Human Review from the node list. A new node appears on the canvas connected to the trigger.
3

Configure the Node

Click the human review node to open its settings panel:
  • Response type: Select “Single Select”
  • Options: Add “Approve”, “Reject”, and “Escalate”
  • Reviewers: Select a group from your Humans directory (or choose Universe for all reviewers)
  • Timeout: Set to 3600 seconds (1 hour)
  • Default response: Set to “Reject” as a safe fallback

Step 3: Save and Activate

1

Save the Workflow

Click Save in the top-right corner. Your workflow is saved as a draft.
2

Activate

Click the Activate toggle. The workflow is now live and listening for webhook triggers. You will see the webhook URL displayed at the top of the designer.
3

Copy the Webhook URL

Copy the webhook URL. It looks like this:

Step 4: Trigger the Workflow

Send a POST request to your webhook URL to create an execution:

Step 5: Respond to the Review

Once the workflow is triggered:
  1. The assigned reviewers receive a push notification on the HITL.sh mobile app
  2. Open the app and tap on the pending review
  3. Select one of the options (Approve, Reject, or Escalate)
  4. Submit the response
The workflow execution completes and the response is recorded.

Step 6: View the Execution

Go back to the workflow designer and click the Executions tab. You will see your execution with:
  • The trigger payload
  • The human review response
  • The total execution time
  • The reviewer who responded

What’s Next

Workflow Designer Guide

Learn about all node types, canvas controls, and advanced configuration

Response Types

Explore all seven response types and their configurations

Humans

Set up groups and people for reviewer assignment

Integrations

Connect your workflow to n8n, Zapier, Make, and more