Request a review

Prepare

HTTP
n8n
Make
Python SDK
JS SDK

Send requests for review to our API directly.Details are documented in Request review.

In your Make scenario, add a new module, search for gotoHuman and select our Create a Review Request module.When setting up a connection, enter your gotoHuman API key.Read more in our Make integration guide.

Install our SDK:

pip install gotohuman

Set environment variables with your gotoHuman API key and the ID of your agent:

GOTOHUMAN_API_KEY=YOUR_API_KEY
GOTOHUMAN_AGENT_ID=YOUR_AGENT_ID

If you’re using a .env file, don’t forget to load it:

from dotenv import load_dotenv
load_dotenv()

Initialize the SDK:

from gotohuman import GotoHuman

gotoHuman = GotoHuman()  # reads GOTOHUMAN_API_KEY and GOTOHUMAN_AGENT_ID

You can also pass both values explicitly:

gotoHuman = GotoHuman(api_key="YOUR_API_KEY", agent_id="YOUR_AGENT_ID")

Install our SDK:

npm i gotohuman

Set environment variables with your gotoHuman API key and the ID of your agent:

GOTOHUMAN_API_KEY=YOUR_API_KEY
GOTOHUMAN_AGENT_ID=YOUR_AGENT_ID

Initialize the SDK:

import { GotoHuman } from "gotohuman"

const gotoHuman = new GotoHuman()

You can also pass both values explicitly:

const gotoHuman = new GotoHuman({
  apiKey: "YOUR_API_KEY",
  agentId: "YOUR_AGENT_ID",
})

Send request

Pass the ID of the review type and the agent identity you created and pass the data to review as shown in the review type editor.

HTTP
n8n
Make
Python SDK
JS SDK

{
  "agentId": "ag123456",
  "formId": "abcdef12345",
  "data": {
    "crmUpdate": {
      "entryId": "123456abcdef",
      "amount": 42000,
      "stage": "proposal"
    }
  },
  "config": {
    "fields": {
      "stageSelect": {
        "options": [
          { "id": "proposal", "label": "Proposal" },
          { "id": "negotiation", "label": "Negotiation" },
          { "id": "won", "label": "Won" }
        ]
      }
    }
  },
  "meta": {
    ...
  }
}

review = gotoHuman.create_review("YOUR_REVIEW_TYPE_ID")
review.set_review_data({
    "example1": "value1",
    "example2": true,
})
review.set_review_config({...})
review.set_meta_data({...})
try:
    response = review.send_request()  # or: await review.async_send_request()
    print("Review sent successfully:", response)
except Exception as e:
    print("An error occurred:", e)

const reviewRequest = gotoHuman.createReview("YOUR_REVIEW_TYPE_ID")
  .setReviewData({
    "example1": "value1",
    "example2": true,
  })
  .setReviewConfig({...})
  .setMetaData({...})

await reviewRequest.sendRequest()

See API Reference for the request properties.

Images / Videos

For images and videos – including CDN storage, URLs, base64, file uploads, and image editing – see Images and videos.

Assign reviewers

To send a review request only to selected users of your team, add a list of email addresses of those users. Use the email address used when signing up for gotoHuman.
Available on Team plan and above.
This otherwise defaults to all users or the user who triggered the workflow.

You can also assign reviewers on the review type for all requests of that type. A request-level assignment takes precedence over the review type assignment.

HTTP
n8n
Make
Python SDK
JS SDK

{
  "formId": "abcdef12345",
  "fields": {
    ...
  },
  "assignTo": ["[email protected]"]
}

Our n8n node shows a field Assigned Users. Select All Users or alternatively Only selected users and map or enter their email addresses.Read more in our n8n integration guide.

Our module shows a field Assigned Users. Select All Users or alternatively Only selected users and map or enter their email addresses.Read more in our Make integration guide.

review = gotoHuman.create_review("abcdef12345")
review.set_review_data({...})
review.assign_to_users(["[email protected]"])
try:
    response = review.send_request()
    print("Review sent successfully:", response)
except Exception as e:
    print("An error occurred:", e)

const reviewRequest = gotoHuman.createReview("abcdef12345")
  .setReviewData({...})
  .assignToUsers(["[email protected]"])

await reviewRequest.sendRequest()

GET STARTED

Human reviews

Notifications

Integrations

API Reference

Examples

More

Prepare

Send request

Images / Videos

Assign reviewers

​Prepare

​Send request

​Images / Videos

​Assign reviewers

Prepare

Send request

Images / Videos

Assign reviewers