Using HTTP + Webhook nodes
If you need more control over the asynchronous flow, access to the review URL, or want to use the review response in a different workflow, use the approach outlined below.
The simplest way to integrate gotoHuman in your n8n workflow is to use our verified n8n node.
Usage
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
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 HTTP to find the JSON payload to send. 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.
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.
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>.
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.
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 (AI Retries / Prompt Edits), 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.
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.
More info about the webhook response here.