Documentation — WorkForYourWorld

Quick Start Guide

Get WorkForYourWorld running in your organization in under 30 minutes. This guide covers account setup, your first HRIS sync, and deploying your first AI match session.

Note: You'll need admin access to your HRIS system and a WorkForYourWorld Enterprise account. Start your free trial at workforyourworld.tech.

Create your WorkForYourWorld account and generate your Organization API key from the Settings → API Keys panel.

Install the HRIS sync connector for your system (Workday, SAP, BambooHR, or generic SCIM endpoint).

Run your first workforce sync. The AI engine will begin constructing your skill graph immediately — typically completes in 8–12 minutes for up to 10,000 employees.

Select your SDG priorities and configure your first impact session from the Command Center.

The match engine begins running inference. Your first matches will appear within 60 seconds.

Connect Your Organization

WorkForYourWorld ingests workforce data via HRIS connectors or our SCIM-compliant REST API. All data is encrypted in transit (TLS 1.3) and at rest (AES-256). Raw employee data never leaves your environment.

Workday Integration

Use the Workday Integration System User (ISU) with the following minimum permissions: Worker Data: All Positions, Worker Data: Skills, Staffing.

# Install the Workday connector
wfyw integrations install workday   --tenant-id YOUR_TENANT_ID   --isu-username YOUR_ISU_USER   --isu-password YOUR_ISU_PASS   --sync-interval daily

Generic SCIM Endpoint

If your HRIS supports SCIM 2.0, point it at your WorkForYourWorld SCIM endpoint with Bearer token authentication.

SCIM Endpoint: https://api.workforyourworld.tech/scim/v2
Bearer Token: wfyw_scim_<your_org_token>

Configure Impact Goals

Impact goals define which SDG categories and opportunity types the AI match engine will prioritize for your organization. Goals can be weighted, combined, and updated at any time without downtime.

{
  "impact_goals": [
    { "sdg": 13, "weight": 0.4, "label": "Climate Action" },
    { "sdg": 8,  "weight": 0.3, "label": "Decent Work" },
    { "sdg": 4,  "weight": 0.2, "label": "Quality Education" },
    { "sdg": 10, "weight": 0.1, "label": "Reduced Inequalities" }
  ],
  "match_threshold": 0.75,
  "reporting_framework": "CSRD"
}

Webhooks

Subscribe to real-time events from the WorkForYourWorld platform. Webhooks are delivered via HTTPS POST with HMAC-SHA256 signature verification.

Available Events

match.created          # New AI match dispatched
match.completed        # Employee completed an impact task
session.started        # Impact session activated
session.paused         # Session paused from Command Center
report.generated       # Impact report auto-generated
model.retrained        # Match engine model updated
score.updated          # Organization impact score changed

Tip: Use webhooks to push impact events into Slack, Salesforce, or your internal data warehouse in real time.

Build WithWorkForYourWorld