Quickstart

Get up and running with Human Approval in 5 minutes.

1. Create an account

Sign up at humanapproval.dev. No credit card required for the free tier.

2. Create a project

After signing in, go to Projects and create your first project. Give it a name like “Production Approvals”.

Copy your API key - you’ll need this to submit requests.

3. Submit your first request

Use curl or any HTTP client to submit a request:

curl -X POST https://humanapproval.dev/api/v1/requests \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Approve $500 refund for customer #123",
    "payload": {
      "customer_id": "cust_123",
      "amount": 500,
      "reason": "Product defective"
    }
  }'

You’ll get back a response with the request ID and status:

{
  "id": "req_abc123",
  "status": "pending",
  "inserted_at": "2026-01-18T12:00:00Z"
}

4. Review and decide

Go to your dashboard. You’ll see the request waiting for your decision.

Click it to see the full details, then approve or reject. Add a note if you want.

5. Set up webhooks (optional)

To get notified when a decision is made, add a webhook URL to your project settings. We’ll POST the decision there automatically.

See Webhooks for details.

Next steps