Human In Circuit DocsAPI v2 · Contract 2.0.0
Browse all documentation

Start

OverviewQuickstartStandalone decisionsConceptsReview playground

Build

Claude & ChatGPTAuthenticationAPI ReferenceCallbacksTroubleshooting

Integrations

Workflow templatesn8nZapier
Human In Circuit documentation

Add a human approval step in minutes.

Your workflow sends a decision request, a person approves, edits or rejects it on their phone, and the workflow resumes with a structured result.

POST https://humanincircuit.com/v2/reviews
Authorization: Bearer <YOUR_API_KEY>

{
  "inbox_key": "general",
  "title": "Approve the drafted reply"
}
n8n quickstartRecommendedImport the subworkflow and complete your first human review.Review playgroundEdit a request body and watch the mobile review update live.API referenceMethods, URLs, headers, bodies and exact schemas.Claude & ChatGPTConnect an assistant and choose what it can see and do.CallbacksReceive signed review.resolved events and verify them.Workflow templatesDownload the n8n workflow or build the Zapier recipe.

Fastest path with n8n

  1. 1Download and import the Human In Circuit n8n subworkflow.
  2. 2Prepare the workflow step whose output needs human review.
  3. 3Open the General project created with your account.
  4. 4Generate an API key for the project.
  5. 5Submit the review and let n8n wait.
  6. 6Review it in a browser or the installed mobile app.
  7. 7Continue the workflow from the callback result.
Build your first n8n review

How the pieces fit together

  • Project: groups related agents and workflows inside one business area.
  • Agent and workflow: identify what produced each review.
  • API key: authenticates n8n. Every API key belongs to exactly one project.
  • Project key: a permanent, readable identifier such as customer-support. It is returned by the API and callbacks so you can distinguish projects.
  • Review ID: identifies one individual review.
  • Callback: sends the completed decision back to n8n.
  • Polling: lets an application retrieve the completed decision later.

Integration guides

  • n8n: the recommended starting point, with a downloadable workflow.

Reference

Reuse a workflow

Workflow templates includes the downloadable n8n subworkflow and the Zapier request/continuation recipe.