Skip to main content
n8n Logo

n8n cloud

self-hosted

If you run a self-hosted n8n instance, you can use our n8n community node.

Use gotoHuman to easily include human reviews in your n8n workflows.

gotoHuman comes with many built-in features:

  • Ready-to-use web UI
    • Inbox
    • Customizable review interface
    • Controls to approve, reject, or edit AI outputs
    • Allow retries with instructions
    • Supports text, markdown, JSON, images, and more
  • Slack integration
  • Notifications
  • Response dataset to use as memory
  • And much more!
n8n Flow

Usage​

To integrate gotoHuman in your n8n cloud workflow, you'll need to add two nodes:

  • A HTTP Request node to send the review request

  • A Webhook node that triggers when the review is completed

n8n Adding the nodes

Set up the review​

First off, you need to have a gotoHuman account. If you don't have one, you can sign up here.
In gotoHuman, create a review template.
You tailor it to your use case and add all the fields needed to capture content to review, any helpful context, and to collect additional input from the reviewer.
Don't forget to save/create it before proceeding.

Copy API Key and JSON​

The JSON payload to send to the gotoHuman API with your HTTP Request varies depending on the fields you added to your review template.
After saving/creating the form/template, click API Request and select n8n to find the JSON payload to send under n8n cloud. Copy it. It includes example values that we will replace with the actual values in the next step.
Here you can also find your API Key. Copy it as well.

n8n HTTP Request Body

Note: In the overview of your review template, you'll see a field to enter a webhook endpoint. We'll get the URL to enter here from the webhook node in n8n that we'll set up below.

caution

When changing your review template at any time (e.g. add a field), remember to update the JSON payload in the node.

Add HTTP Request node​

In n8n, add a HTTP Request node.

Set it up for a POST to https://api.gotohuman.com/requestReview with a Generic Credential Type of type Header Auth.
Create a new credential with Name x-api-key and Value <your API key>.

n8n HTTP Request Node n8n HTTP Request Node

Enter values to review​

Select to Send Body of type JSON, Using JSON.
Enter double curly braces {{ and paste in the JSON payload you copied from gotoHuman.
Now replace the example values with the actual values you want to send.

n8n HTTP Request JSON

Enter meta data (optional)​

meta: You can optionally add additional data that you will receive back in the response. This can be data from previous nodes or from the workflow execution to work with this in the workflow triggered by the response webhook.

Assign users​

assignTo: Select whether you want everyone on your account to be able to complete the review or you want to assign only selected users.

Update review​

updateForReviewId: When allowing reviewers to request a retry, you can update the review with the newly generated content by referencing its' ID.

More infos about additional values you can send here: Send review requests.

Add webhook node​

In n8n, add a Webhook node and copy the URL to gotoHuman as the webhook endpoint for your review template, s. above.

n8n webhook url Insert n8n webhook url

Listen for a (test) event​

Once you request the first review, make your webhook node listen for a (test) event and submit the review.
Now you will see the response and can use the values in your following nodes.

n8n webhook response

More info about the webhook response here.