Integrations

Active third-party integrations powering the Illumera platform.

AI Integrations

Anthropic Claude — Scoring Engine

Powers the spider scoring engine. Provides a calibration delta on top of deterministic axis scores, accounting for signal quality and profile completeness across the Culture Fit, Experience, and Domain Depth dimensions.

OpenAI (gpt-4o-mini) — Resume Parsing

Powers the resume skill extraction feature. When a talent uploads a resume, the model extracts structured skills and experience records and maps them to the Illumera skill taxonomy.

The AI integration credentials are configured via environment variables on the API server. Without a valid Anthropic key, the scoring engine falls back to deterministic-only scoring. Without a valid OpenAI key, the resume upload skill extraction feature is disabled.

Email — Resend

Illumera uses Resend for transactional email delivery (engagement invitations, onboarding notifications, and system alerts). The integration requires a RESEND_API_KEY environment variable configured on the API server.

Without a valid RESEND_API_KEY, email functions are silently disabled — the platform operates normally but no notifications are delivered.

Authentication — Clerk

Illumera uses Clerk for identity management, email verification, and session handling. The integration is configured via standard environment variables:

• CLERK_SECRET_KEY — backend secret used by the Express middleware to verify session tokens.
• VITE_CLERK_PUBLISHABLE_KEY — frontend publishable key used by the React app and this docs site.

User creation and management for demo accounts must be done in the Clerk dashboard. The platform syncs user data on first login via a Clerk webhook. Roles are stored in the Illumera PostgreSQL database — not in Clerk publicMetadata.

File Storage — Tigris (S3-compatible)

Avatar uploads and document storage use Tigris object storage via the AWS SDK. Configure with the following environment variables on the API server:

• AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY
• S3_BUCKET / S3_ENDPOINT / S3_REGION
• S3_PUBLIC_URL — the public CDN URL for serving uploaded assets

Without storage configuration, avatar upload is disabled — the platform displays a placeholder avatar and continues to operate normally.

Payment Rails — Stripe Connect

Status: Schema and API endpoints defined — not yet wired to Stripe

The Stripe Connect database schema and stub API routes are present in the codebase (company stripeAccountId, stripeAccountStatus columns; /payments/* route group). No live Stripe credentials are connected and no real payment flows are active. When the payment rail is enabled, Stripe Connect will handle the B2B payment flow — automated invoice generation, contractor payout routing, and platform fee splits. This section will be updated with admin setup instructions (Stripe Dashboard → Connect onboarding → webhook configuration) when the feature is live.

Align — Project & Time Sync

Illumera integrates bi-directionally with Align, a client-feedback and project management platform used in government contracting. Once connected, Illumera automatically mirrors projects, talent members, time entries, and staffing wiki pages into your Align organization — and receives real-time approval status updates back via webhook.

What syncs:

Illumera action	Result in Align
Project created / updated	Align project created or updated
Engagement accepted	Talent provisioned as Align user; added as project member
Time entry submitted	Time entry pushed to Align and submitted for approval
Project activated	Staffing plan wiki page written to the Align project

To connect: Navigate to Company Settings → Integrations → Align, paste an organization-scoped API key from https://app.alignsoft.us/admin/developer/keys, and click Save. Illumera validates the key and registers a webhook automatically.

For complete setup instructions, sync status monitoring, and troubleshooting, see the Align Integration guide.

For the full technical specification (database schema, sync worker, webhook handler, and reconciliation job), see the Align Integration Reference.