Quick Start

Get set up, then pick the guide for what you’re building: collecting approvals or verifying agent actions.

Humanos turns human authorization into programmable, verifiable events. This page gets you set up and points you at the right walkthrough.

Before you start

1. Grab your API Key and Signature Secret from the dashboard and sign every request. See Authentication.
2. Point a webhook endpoint at Humanos to receive outcomes. See Webhooks.
3. Pin an API version with the API-Version header. See Versioning.

On Node.js or TypeScript? The Humanos SDK wraps every call, including request signing and webhook decryption. The HTTP API and the SDK are equivalent; pick whichever fits your stack.

Pick your path

Collecting Approvals

Ask people to consent, fill forms, or sign documents, and get the signed result back.

Agent Actions

Let an agent act under a scoped policy the user approves, then verify every action.

New to the model? The Introduction covers the core concepts: actions, mandates, verifiable presentations, and the audit trail.