View as Markdown
Peakon Employee Voice icon

Peakon Employee Voice ACTION

Get Driver Scores

Returns engagement scores broken down by Peakon's 14 core drivers: Accomplishment, Autonomy, Environment, Freedom of Opinions, Goal-Setting, Growth, Manager Support, Meaningful Work, Organizational Fit, Peer Relationships, Recognition, Reward, Strategy, and Workload. Each driver includes a score (0–10), grade (positive/neutral/negative), impact rating, and classification (e.g. strength, priority). Pass a contextId formatted as company_[companyId] for company-wide scores or segment_[segmentId] to scope to a specific segment — use List Segments to discover IDs. Use when the user asks 'which drivers are lowest?', 'how is recognition scoring?', or 'what are the priority areas to focus on?'. See the Peakon API documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Peakon Employee Voice account once, then configure and run Get Driver Scores from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "peakon_employee_voice-get-driver-scores",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    peakon_employee_voice: { authProvisionId: "apn_xxxxxxx" },
    contextId: "Context ID",
    interval: "Interval",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Driver Scores inputs
Property Type Description
contextId Context ID string
Company or segment context ID. Format: company_[companyId] for company-wide metrics or segment_[segmentId] for a specific segment. Use List Segments to discover available segment IDs.
Required
interval Interval string
Time interval for analytics data. Defaults to quarter.
Optional
observations Include Observations boolean
Whether to include the observations array in the response. Defaults to false.
Optional
participation Include Participation boolean
Whether to include participation data in the response. Defaults to false.
Optional
filterSegmentIds Filter by Segment IDs string
Comma-separated list of segment IDs to filter by segment membership. Example: 1001,1002. Use List Segments to discover available segment IDs.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
peakon_employee_voice-get-driver-scores
Version
0.0.2
App
Peakon Employee Voice
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes