Skip to main content

Integration Process Flow

Data Flow

  • During the initial setup phase and when new skill vocabulary versions are released, TechWolf will push and update the external skill mapping in Degreed.
  • Employee Skills are synchronized based on the configured sync direction and trigger mechanisms. TechWolf → Degreed updates are synchronized in real-time using a push strategy.
  • Degreed → TechWolf updates are synced based on tenant configuration and system triggers. This means that all flows are initiated by TechWolf.
Employee skills synced by the Degreed Integration are tracked using the source field in the Employee Skill Profile Feedback endpoint payload, tagged as "degreed-integration". To retrieve these sources in an Employee’s profile, use the query parameter &include=sources in the Employee Skill Profile Feedback endpoint , which returns the Skill’s source_event with "event_type": "skill_profile_feedback" and "source": "degreed-integration". In summary: TechWolf will access Degreed’s REST API v2 to retrieve and update skills data. TechWolf also synchronizes skills data from external sources and skills from external systems performing skill harmonization.

Sync Direction Configuration

The integration supports three sync direction options:

Bidirectional Sync (Default)

  • Direction: bidirectional
  • Behavior: Two-way sync between TechWolf and Degreed
  • Use Case: Full integration with data flowing both ways

Uni-directional Sync Options

Degreed → TechWolf Only

  • Direction: to_techwolf
  • Behavior: Skills flow from Degreed to TechWolf only
  • Use Case: Customers using Skill Suggestions Push integration

TechWolf → Degreed Only

  • Direction: to_external
  • Behavior: Skills flow from TechWolf to Degreed only
  • Use Case: Customers with conflicting proficiency rules

Initial Load

The initial load occurs after the Degreed API key credentials are shared and set up in TechWolf. The TechWolf team ensures the initial batch of data is loaded into both systems, starting a process on TechWolf’s side. During the initial data load, customers can choose between three synchronization strategies:
  1. Merge Systems (merge_systems): Combines skills from both Degreed and TechWolf systems. Skills present in Degreed but not in TechWolf will be synced to TechWolf, and vice versa. This preserves existing skill data in both systems. TechWolf takes precedence over Degreed in case of conflicting values.
  2. Push TechWolf (push_techwolf): Replaces all skills in Degreed with the skill data from TechWolf. This strategy clears existing Degreed skills before importing TechWolf data.
  3. Push External (push_external): Replaces all skills in TechWolf with the skill data from Degreed. This strategy clears existing TechWolf skills before importing Degreed data.
These synchronization strategies are automatically applied to any new Employees that exist in both Degreed and TechWolf systems.

Important Limitation: Degreed-First Precedence

Some customers may require a variation where Degreed takes precedence over TechWolf for overlapping skills. This use case is not natively supported by the current synchronization strategies. Workaround:
  • Request a snapshot export from Degreed containing all skills and proficiency values.
  • Import this snapshot as feedback into TechWolf to align TechWolf’s profiles with Degreed.
  • After alignment, use either the Merge Systems, Push TechWolf, or Push External strategy for the initial sync. The result will effectively preserve Degreed’s precedence while still enabling bidirectional synchronization.

Skill Validation in Degreed

When an employee provides feedback in Degreed, for example, adds “Machine Learning” and removes “Data Analysis”, the changes are reflected in TechWolf accordingly. The changes are synchronized based on the configured sync direction and trigger mechanisms.

Proficiency Scale Configuration

Degreed supports configurable proficiency scales:
  • Default: 8-point scale (1-8)
  • Alternative: 6-point scale (1-6)
  • Configuration: Set via degreed_maximum_proficiency_level tenant setting
When TechWolf sends proficiency data to Degreed:
  • Multiple ratings: Multiple ratings of the same type are allowed for a single skill
  • UI display: Only the most recent rating is shown in the Degreed UI
  • Persistence: Old ratings are not deleted when new ones are added
  • Rating type: Currently uses “self” ratings for TechWolf-sourced skills

User Identifier Configuration

The integration supports two user identifier types:
  • Employee ID (employee-id): Customer-defined identifier (default)
    • Uses the employee_id field from API responses
    • Customer-defined identifier that matches between systems
  • User ID (user-id): Degreed-generated identifier
    • Uses the user_id field from API responses
    • Degreed’s internal user identifier
This configuration determines how employees are matched between TechWolf and Degreed systems.

Skill Name Resolution

Since Degreed skills are free-text format (identified by name, not ID):
  • Skills are mapped by name to TechWolf skill IDs
  • When TechWolf skill names change, the mapping is updated
  • Old skills are removed from Degreed and new skills are added with updated names
  • Proficiency levels are preserved during skill name updates
I