Fetching data...
Developer API Reference
Build powerful integrations with our platform APIs.
Developer API Reference
Build powerful integrations with our platform APIs.
IdP & SSO Integrations
Connect your Identity Provider (Azure AD, Okta, Google) to automate user lifecycles.
1. Authentication (SSO)
Users log in via your corporate IdP. We support standard OIDC and SAML 2.0 flows.
Configuration:Use CLIENT_ID and CLIENT_SECRET provided by your account manager.
2. Provisioning (Sync)
Your IdP tells the platform to create, update, or delete users via API triggers.
Supported Actions:
CreateUpdateDeprovision
Microsoft Entra ID (Azure AD) Guide
1. App Registration
In Entra ID portal, go to Enterprise Applications → New Application → Create your own application. Select "Integrate any other application you don't find in the gallery".
2. Configure On-Demand Provisioning
Entra supports "Custom SCIM" endpoints, but often for simplicity we recommend using Logic Apps or Power Automate to hit our REST API directly.
Logic App TriggerWhen user added to group
HTTP Request:
POST https://your-tenant.peoplelensai.com/api/users
Headers:
Authorization: Bearer <API_KEY>
Content-Type: application/json
Body:
{
"email": "@{triggerBody()?['userPrincipalName']}",
"first_name": "@{triggerBody()?['givenName']}",
"last_name": "@{triggerBody()?['surname']}",
"role": "User"
}Okta Guide
1. Create App Integration
Go to Applications → Create App Integration → Select SAML 2.0 (for Auth) or API Services (for Sync).
2. Okta Workflows (Lifecycle Management)
Use Okta Workflows to call our API based on user lifecycle events.
User Assigned
POST /api/usersUser Deactivated
DELETE /api/users/[id]Google Workspace Guide
1. OAuth 2.0 Setup
In Google Cloud Console, create a new OAuth Client ID. Add https://peoplelensai.com/api/auth/callback/google to your Authorized Redirect URIs.
2. Directory Sync (Users)
Automate seat management using Google Apps Script or GAM to sync your Workspace groups to our User API.
Apps Script Example
function syncUsers() {
const users = AdminDirectory.Users.list({domain: 'yourdomain.com'}).users;
users.forEach(user => {
UrlFetchApp.fetch('https://api.peoplelensai.com/v1/users', {
method: 'post',
headers: { 'Authorization': 'Bearer ' + API_KEY },
payload: JSON.stringify({
email: user.primaryEmail,
first_name: user.name.givenName,
last_name: user.name.familyName,
external_id: user.id
})
});
});
}