Website Privacy Terms
Register

Personio Integration

Home / Tools / Guides / Personio Integration

Overview

Connect Intercultural Teams with Personio to sync employee data and provide cultural intelligence tools to your international workforce.

Integration method: Enterprise API (Personio does not natively support LTI 1.3) User sync: Via Personio API webhooks or scheduled export

Prerequisites

  • Personio account with API access enabled
  • Personio API credentials (Client ID and Client Secret)
  • Intercultural Teams enterprise account with admin access

Step 1: Create an API Key in Intercultural Teams

  1. Log in to your Intercultural Teams admin panel
  2. Navigate to Admin > L&D Plugins
  3. Click Add Platform:
    • Name: e.g. "Acme Corp Personio"
    • Platform Type: Personio
    • Leave the LTI fields empty (Personio uses API-only integration)
  4. Go to the API Keys tab and click Generate API Key:
    • Tenant Name: e.g. "acme-personio"
    • Platform: Select your Personio platform
  5. Copy the API Key and Secret immediately

Step 2: Configure User Sync

Sync employee data from Personio to Intercultural Teams:

Option A: Webhook-based (recommended)

  1. In Personio, go to Settings > Integrations > Webhooks
  2. Create a webhook for employee creation/update events
  3. Point it at a middleware (e.g. Zapier, Make, or a custom Lambda) that transforms the data and calls POST /api/enterprise/v1/users/sync

Option B: Scheduled sync

  1. Set up a scheduled job (cron, Lambda, etc.) that:
    • Fetches employees from Personio's REST API
    • Transforms the data to match our sync format
    • Calls POST /api/enterprise/v1/users/sync

Required fields mapping:

Personio Field Intercultural Teams Field
Employee ID external_id
Email email
First Name first_name
Last Name last_name
Department department
Office location
— country_code (derive from office location)

Step 3: Embed Cultural Tools

Since Personio doesn't support LTI, you can embed Intercultural Teams content via:

  1. Direct links — Share links to cultural tools in Personio's onboarding checklists or custom sections
  2. Simulator embed — Use POST /api/enterprise/v1/simulator-access to generate time-limited embed URLs for iframe embedding
  3. Custom portal — Build a lightweight portal page that uses the Enterprise API to display cultural profiles and training

Step 4: Use Cultural Data in Personio

Retrieve cultural insights via the Enterprise API for use in Personio workflows:

  • GET /api/enterprise/v1/cultural-profile/{employeeId} — Get an employee's cultural profile
  • POST /api/enterprise/v1/team-culture-comparison — Compare a team's cultural diversity
  • POST /api/enterprise/v1/assignment-briefing — Generate a briefing for international assignments

See the Enterprise API Reference for full documentation.

Troubleshooting

Sync fails with "No platform associated" Ensure the API key is linked to your Personio platform in Intercultural Teams.

Employee IDs not matching Use the Personio Employee ID (numeric) consistently as the external_id in all API calls.

Back to Guides