Getting Started

This guide walks you through setting up your Trua Cloud integration for employment verification — from accessing your portal to sending your first candidate invitation.

What Is Trua Cloud?

Trua Cloud is a platform that collects candidate information through a secure, mobile-first wizard. You send candidates an invitation link; they complete their employment history, biometric enrollment, and electronic signature on any device. Trua then verifies the information and delivers results back to you.

What you provide: Candidate name, email, and (optionally) phone number.
What Trua handles: Invitation delivery, data collection, identity verification, employment verification, and result delivery.

How It Works

You create invitation → Candidate receives link → Completes wizard →
Trua verifies → Results delivered to you (API, webhook, or portal)

The candidate experience takes 5–10 minutes. No account creation, no app download — just a link that works on any device.

Step 1: Access Your Portal

Your customer portal is at:

https://trua.cloud/sites/{YOUR_CODE}

Log in with the credentials provided by your Trua Cloud account representative. The portal gives you access to:

• Dashboard — Invitation status and verification progress
• API Keys — Manage test and live keys
• Test Harness — Try the API from your browser
• Documentation — Guides and API reference specific to your organization

Step 2: Review Your API Keys

Navigate to API Keys in your portal. You have two environments:

Important: API key values are shown only once when created. Store them securely.

Step 3: Choose Your Integration

Option A: Admin Panel Only (No Code)

Best for: pilot phase, low volume, or non-technical teams.

1. Log in to the Trua Cloud admin panel
2. Go to Invitations → New
3. Enter the candidate's name, email, and (optionally) phone number
4. Click Create & Send
5. Monitor progress in the admin panel
6. Download results when verification is complete

Option B: API Integration

Best for: ATS/HRIS integration where you want to automate the workflow.

Create invitations programmatically and poll for results:

curl -X POST https://trua.cloud/api/v1/invitations \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "candidate_email": "john.doe@example.com",
    "candidate_first_name": "John",
    "candidate_last_name": "Doe",
    "external_id": "YOUR-SYSTEM-ID-123"
  }'

See the Collection Customer API Guide for full endpoint documentation.

Option C: API + Webhooks

Best for: high-volume operations where you want real-time notifications.

Same as Option B, but add a callback_url to receive events as they happen — invitation sent, form submitted, verification completed. No polling required.

Step 4: Send a Test Invitation

Before going live, test the full flow using sandbox mode:

1. Use a test key (sk_test_) to create an invitation via API or use the Test Harness in your portal
2. The API returns fixture responses without sending real emails
3. To test the actual candidate experience, create a live invitation to your own email from the admin panel

Step 5: Go Live

When you're ready for production:

1. Switch from sk_test_ to sk_live_ keys
2. Verify your webhook endpoint is receiving events (if using webhooks)
3. Create your first real invitation
4. Monitor progress in your portal

What Candidates See

When a candidate receives an invitation, they click a single link and complete these steps:

1. Personal Information — Name and email
2. Biometric Enrollment — Facial capture for identity verification
3. Employment History — Employers, dates, titles, and supervisor contacts
4. Review — Verify all information is correct
5. Signature — Electronic signature and attestation

See the Employment Verification Workflow guide for a detailed walkthrough of each step.

What You Receive

Once a candidate submits, you get:

• All candidate-entered data (employers, dates, contacts)
• Biometric enrollment confirmation
• Digital signature and attestation timestamp
• Requirement fulfillment status (which rules were met vs. flagged)
• PDF document with integrity hash for chain of custody
• Verification results when complete

Customization

The process is configured for your organization:

Contact your Trua Cloud account representative to adjust any of these settings.

Next Steps

• Employment Verification Workflow — Detailed candidate experience walkthrough
• Collection Customer API Guide — Full API reference
• UAT Guide — User acceptance testing procedures