# Peakon Employee Voice — Pipedream Connect

> Peakon Employee Voice is a continuous listening platform that lets employees share feedback and view insights while enabling managers and leaders to track engagement, understand team sentiment, and take action from anywhere.

- API slug: `peakon_employee_voice` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Human Resources
- Website: https://www.workday.com/en-us/products/employee-voice/overview.html
- This page (HTML): https://pipedream.com/apps/peakon-employee-voice
- Tools: 7 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: peakon_employee_voice`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "peakon_employee_voice",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Create Employee:
const result = await mcp.callTool({
  name: "peakon_employee_voice-create-employee",
  arguments: {
    firstName: "First Name",
    lastName: "Last Name",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Peakon Employee Voice endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.example.com/v1/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vdjEvbWU?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
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-create-employee",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    peakon_employee_voice: { authProvisionId: "apn_xxxxxxx" },
    firstName: "First Name",
    lastName: "Last Name",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (7)

### `peakon_employee_voice-create-employee` — Create Employee (Write)

Creates a new employee record in Peakon. Requires firstName, lastName, and identifier (the HR employee number, e.g. E001 — must be unique). Optional standard fields: email, employeeType (permanent/contractor/temporary/volunteer/other), employmentStatus. Custom HR attributes such as Department…

Full schema: https://pipedream.com/apps/peakon-employee-voice/actions/create-employee.md

### `peakon_employee_voice-delete-employee` — Delete Employee (Write)

Permanently deletes an employee record from Peakon. This action is irreversible — the employee and all associated survey data will be removed. Use List Employees to find the employee's id first. Returns a confirmation when deletion succeeds. See the Peakon API documentation

Full schema: https://pipedream.com/apps/peakon-employee-voice/actions/delete-employee.md

### `peakon_employee_voice-get-driver-scores` — Get Driver Scores (Read-only)

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…

Full schema: https://pipedream.com/apps/peakon-employee-voice/actions/get-driver-scores.md

### `peakon_employee_voice-get-engagement-overview` — Get Engagement Overview (Read-only)

Returns the engagement score, response rate, NPS breakdown, and favorability data for a company or specific segment context. Pass a contextId formatted as company_[companyId] for company-wide metrics or segment_[segmentId] for a specific segment — use List Segments to discover segment IDs. Use when…

Full schema: https://pipedream.com/apps/peakon-employee-voice/actions/get-engagement-overview.md

### `peakon_employee_voice-list-employees` — List Employees (Read-only)

Lists employee records in Peakon. Use the filter parameters to narrow results by email, account ID, admin status, employee ID, manager status, or segment membership. Returns each employee's internal id, name, identifier (HR employee number), employment status, and custom HR attributes (Department…

Full schema: https://pipedream.com/apps/peakon-employee-voice/actions/list-employees.md

### `peakon_employee_voice-list-segments` — List Segments (Read-only)

Lists all demographic and organizational segments configured in Peakon. Each segment includes a contextId that can be passed to Get Engagement Overview and Get Driver Scores to scope analytics to a specific population (e.g. a department, region, or tenure band). Call this first whenever the user…

Full schema: https://pipedream.com/apps/peakon-employee-voice/actions/list-segments.md

### `peakon_employee_voice-update-employee` — Update Employee (Write)

Partially updates an existing employee's attributes using their internal ID. Only the fields you provide will be updated — omitted fields are left unchanged. Use List Employees to find the employee's id first. Standard fields: firstName, lastName, identifier, employmentStatus. Custom HR attributes…

Full schema: https://pipedream.com/apps/peakon-employee-voice/actions/update-employee.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt
