Quickstart

Learn how to integrate People Index into your existing HR tech stack (like Workday, BambooHR, or custom ATS) in under 15 minutes.

1. Obtain API Keys

First, navigate to your Developer Dashboard and generate a new pair of API keys. You will need a publishable_key for frontend consent flows, and a secret_key for backend API calls.

2. Install the SDK

The easiest way to interact with the People Index API is through our official SDKs. If your HR backend runs on Node.js, install the NPM package:

npm install @peopleindex/node

3. Issue a Verifiable Credential

When an employee joins your organization or changes titles in your HRMS (e.g., Workday), you can trigger an event to issue a Verifiable Credential to their Identity Wallet.

import { PeopleIndex } from '@peopleindex/node';

const idx = new PeopleIndex(process.env.IDX_SECRET_KEY);

const credential = await idx.credentials.issue({
  subjectId: "usr_29dn39dmk2",
  schema: "EmploymentHistory_v2",
  claims: {
    employerName: "Acme Corp",
    title: "Senior Engineer",
    startDate: "2022-01-15",
    status: "ACTIVE"
  }
});

console.log('Successfully issued credential:', credential.id);