Skip to main content
Advanced webhook system is only available in Humancheck Platform, not in the open-source version.Open Source supports basic webhook notifications via connectors.
Webhooks allow you to receive real-time notifications when review events occur in Humancheck Platform.

​
Setting Up Webhooks

​
Via Dashboard UI

  1. Go to platform.humancheck.dev
  2. Navigate to Integrations → Webhooks
  3. Click Create Webhook
  4. Configure:
    • Webhook URL
    • Events to subscribe to
    • Authentication (optional)
    • Retry settings

​
Via API

import httpx

async with httpx.AsyncClient() as client:
    response = await client.post(
        "https://api.humancheck.dev/webhooks",
        headers={
            "Authorization": "Bearer your-api-key-here",
            "Content-Type": "application/json"
        },
        json={
            "url": "https://your-app.com/webhooks/humancheck",
            "events": [
                "review.created",
                "review.assigned",
                "review.decided",
                "review.status_changed"
            ],
            "secret": "your-webhook-secret",
            "active": True
        }
    )
    webhook = response.json()

​
Webhook Events

​
Review Events

  • review.created - New review created
  • review.assigned - Review assigned to reviewer
  • review.decided - Decision made on review
  • review.status_changed - Review status changed
  • review.updated - Review updated

​
Decision Events

  • decision.approved - Review approved
  • decision.rejected - Review rejected
  • decision.modified - Review modified

​
Webhook Payload

{
  "event": "review.decided",
  "timestamp": "2024-01-01T12:00:00Z",
  "data": {
    "review_id": 123,
    "task_type": "payment",
    "status": "approved",
    "decision": {
      "decision_type": "approve",
      "reviewer_name": "Alice Smith",
      "timestamp": "2024-01-01T12:00:00Z"
    }
  }
}

​
Security

​
Signature Verification

Webhooks include a signature header for verification: 
import hmac
import hashlib

def verify_webhook(payload, signature, secret):
    expected_signature = hmac.new(
        secret.encode(),
        payload.encode(),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected_signature)

​
Retry Logic

Platform automatically retries failed webhook deliveries:
  • Immediate retry on failure
  • Exponential backoff
  • Maximum 3 retries
  • Dead letter queue for persistent failures

​
Multi-User Approval Workflows

Platform supports complex approval workflows via webhooks:

​
Sequential Approval

{
  "workflow_type": "sequential",
  "approvers": ["[email protected]", "[email protected]"],
  "current_step": 1,
  "total_steps": 2
}

​
Parallel Approval

{
  "workflow_type": "parallel",
  "approvers": ["[email protected]", "[email protected]"],
  "required_approvals": 2
}

​
Conditional Workflow

{
  "workflow_type": "conditional",
  "conditions": [
    {
      "if": "amount > 10000",
      "then": ["[email protected]"]
    },
    {
      "if": "urgency == 'critical'",
      "then": ["[email protected]"]
    }
  ]
}

​
No-Code Integrations

Platform webhooks work seamlessly with no-code platforms:

​
n8n

Connect Humancheck webhooks to n8n workflows for automation.

​
Zapier

Use Zapier to connect Humancheck webhooks to 5000+ apps.

​
Gumloop

Build complex workflows with Gumloop using Humancheck webhooks.

​
Next Steps