Overview

Personhood credential integration lets your app ask a user to prove that they are a human or count as one unique person for a defined purpose. Your app does not need to operate the credential issuer.

The user's Credential Wallet stores credentials. Your app creates a presentation request. The user reviews that request in the wallet, chooses whether to share the required credential, and submits a verifiable presentation back to your app. Your backend verifies the presentation before creating an account, allowing an action, or granting access.

What Are Human and Uniqueness Credentials?

Credential	What it proves	Common app use
Human Credential	The wallet holder has passed a human verification process.	Reduce bot activity, gate human-only features, improve trust in user actions.
Uniqueness Credential	The wallet holder can be treated as one unique person for a defined use case.	Enforce one account, one vote, one claim, or one privileged action per person.

The exact credential type names used by the platform are:

HumanVerifiableCredential
UniquenessVerifiableCredential

Why Use Personhood Credentials?

Apps often need to answer questions that normal login does not answer:

Is this account controlled by a human?
Has this person already performed this one-time action?
Can this participant be counted once without collecting unnecessary identity data?
Can we protect a workflow from bots, duplicate accounts, or repeated claims?

Personhood credentials help your application answer these questions while requesting only the information it needs.

User Flow at a Glance

Your integration has three visible parts:

Your app: frontend, backend, app-owned database, and authorization logic.
Personhood Credential Wallet: the user-facing app that stores credentials and asks for consent.
Presentation Exchange Platform: the developer registration and trust layer for your app metadata, domains, request credential types, and policies.

Your app still owns its own users, sessions, product rules, storage, and final authorization decisions.

sequenceDiagram
    participant Wallet as Personhood Credential Wallet
    participant User as User
    participant Web as Your web app
    participant Store as Your app backend

    User->>Web: Ask for authentication
    Web->>Store: Create verification session
    Web-->>User: Show wallet link or QR code
    User->>Wallet: Reviews and approves request
    Wallet->>Web: Submits verifiable presentation
    Web->>Store: Verify and store the result
    Web-->>User: Continue or deny the action

Download Personhood Credential Wallet from the App Store.

Next Step

Start with Before You Start, then read the Glossary.