Human In Circuit DocsAPI v2 · Contract 2.0.0
Browse all documentation

Start

OverviewQuickstartConceptsReview playground

Build

AuthenticationAPI ReferenceCallbacksTroubleshooting

Integrations

n8nZapier

Zapier integration

Current Zapier support uses Webhooks by Zapier.

Human In Circuit does not yet ship a dedicated Zapier app. Use Zapier webhooks for alpha integrations.

Submit a review

Use Webhooks by Zapier → Custom Request.

Method:

POST

URL:

https://humanincircuit.com/v1/reviews

Headers:

Authorization: Bearer <HIC_PROJECT_API_KEY>
Content-Type: application/json
Idempotency-Key: <stable-zap-item-id>

Body:

{
  "title": "Approve Zapier output",
  "workflow_key": "publish-output",
  "summary": "A Zap generated something that needs review.",
  "initial_values": {
    "message": "Generated text..."
  },
  "fields": [
    {
      "key": "message",
      "label": "Message",
      "type": "textarea",
      "required": true
    }
  ],
  "callback": {
    "url": "https://hooks.zapier.com/hooks/catch/..."
  }
}

Continue after review

Use Webhooks by Zapier → Catch Hook as the continuation trigger.

Allowlist this callback hostname on the Human In Circuit API key:

hooks.zapier.com

Create the corresponding Automation and workflow first in Admin → Agents & workflows. Approval behavior, feedback, and rejection reasons are configured on that workflow's review gate—not inside every Zap request.

Future dedicated app

A future Zapier app can expose:

  • Request Review action;
  • Review Resolved trigger;
  • project/key setup helpers.