Purpose
This guide explains how to connect Workday Peakon Employee Voice to BetterUp, test the connection, and turn it off as needed.
Overview
Peakon shows you how engaged your employees are and how they feel about work. Managers are the ones who respond to that feedback, but reading survey results and deciding what to do next can be hard.
The BetterUp® and Peakon integration links those results to coaching. When a Peakon survey round closes, BetterUp emails each eligible manager with a next step, such as messaging their coach or starting a conversation with BetterUp AI about their results.
The integration requires both a BetterUp administrator and a Peakon administrator.
Jump to: Features | Roles and responsibilities | Configuration and setup | Integration feature detail | Security | FAQs
Features
Post-survey emails to managers. When a Peakon survey round is hard-closed and results reach managers, BetterUp emails each eligible manager. The email's call to action depends on their BetterUp access. See Member experience.
Who qualifies
A manager receives the email when both of these are true:
- They have more than the minimum number of direct reports needed to see Peakon results (a Peakon setting, 5 by default).
- They have BetterUp access through BetterUp Lead, BetterUp Manage™, or BetterUp Care with AI turned on.
Pause anytime. You can turn the integration off in Peakon without losing the connection details.
Roles and responsibilities
| Role | Responsibilities |
|---|---|
| BetterUp admin | Turn on the Peakon integration on the BetterUp integrations page. Copy the credentials and share them securely with the Peakon admin. |
| Peakon admin | Enter the credentials on the BetterUp tile in Peakon. Run a test survey round and confirm a test manager gets the BetterUp email. |
Configuration and setup
Step 1: Turn on the integration in BetterUp
- Go to the BetterUp integrations page.
-
Select Peakon. A confirmation appears.
-
Select Enable. BetterUp shows the Webhook URL, Webhook Secret, and Webhook API Key you need in Peakon.
Note: The Webhook Secret is shown only once. Store it somewhere secure before you leave this screen. When you return to the Peakon integration later, you'll see a limited view.
Step 2: Connect BetterUp in Peakon
-
In Peakon, go to Administration > Integrations.
-
Select the BetterUp tile.
- Enter the Webhook URL, Webhook Secret, and Webhook API Key from Step 1.
- Select Connect.
Step 3: Test the connection
Run a test survey round to confirm managers will get the BetterUp email.
Pick a test manager. Choose someone who can confirm they received the email. They need enough direct reports to see Peakon results (check the number next to their name in the Peakon search box), and an activated BetterUp account with Lead, Manage, or Care.
Create a test round
-
In Peakon, go to Administration > Schedules and select Add schedule.
-
Select your test manager, then select Create Schedule.
- Schedule the round for today's date.
-
Go to Administration > Schedule > Activity.
- Find the round you created and select the down arrow at the far right of the row. When the row expands, select Mark as test, then confirm.
Hard-close the test round
- Turn on Include test rounds.
- Select Hard-close round, then confirm.
Confirm the email arrived
Ask your test manager to check for an email from BetterUp like the one below. The exact email depends on their BetterUp access.
Integration feature detail
Learn more about what managers see and how to pause the integration.
Member experience
Every qualifying manager gets an email from BetterUp after a survey round closes. Where the call to action takes them depends on their access.
| BetterUp access | Where the call to action goes |
|---|---|
| Manage only | A new chat with BetterUp AI on the Messages tab |
| Lead, with a coach assigned | Their conversation with their coach on the Messages tab, with a sample message filled in |
| Lead, without a coach assigned | The scheduling page, to get matched with a coach if needed and book a session |
| Care, with AI turned on for the organization | Same as the Manage only example |
Example emails
(Access to Manage only)
(Access to Lead, with a coach assigned)
(Access to Lead, without a coach assigned)
Let's say a manager with Lead and an assigned coach sees a drop in their team's workload score. The day the round closes, they get an email that opens a message to their coach, already drafted, so they can bring the results to their next session.
Turning off the integration
Turning off the integration stops emails to managers but keeps the connection details, so you can turn it back on later without new credentials.
In Peakon, go to Administration > Integrations, select the BetterUp tile, and select Disable.
Security
Data flows one way, from Peakon to BetterUp. Peakon sends two kinds of data:
- Survey events: metadata about when a survey round starts and when it's hard-closed, such as the survey ID and when it was created.
- Manager details: for each manager who qualifies to see results, their email, number of direct reports, and Workday ID.
Peakon doesn't send survey responses or scores. All times are in ISO 8601 format, UTC.
Sample event payloads
Survey round started
| { "event": "survey_round_started", "sent_at": "2024-05-22T09:34:45.082078Z", "payload": { "company_id": "1111", "survey_round_id": "111111111", "start_date": "2024-05-22T09:34:45.082078Z", "end_date": "2024-06-22T09:34:45.082078Z", "number_of_direct_reports": 5, "manager": { "id": "111111111", "workday_wid": "11111111111111111111111111111111", "email": "employee@customer.com" }, "segments": { "direct_report_segment_id": "1111111", "all_report_segment_id": "1111111" } } } |
Survey round hard-closed
| { "event": "survey_round_hard_closed", "sent_at": "2024-05-22T09:34:45.082078Z", "payload": { "company_id": "1111", "survey_round_id": "111111111", "start_date": "2024-05-22T09:34:45.082078Z", "end_date": "2024-06-22T09:34:45.082078Z", "number_of_direct_reports": 5, "manager": { "id": "111111111", "workday_wid": "11111111111111111111111111111111", "email": "employee@customer.com" }, "segments": { "direct_report_segment_id": "1111111", "all_report_segment_id": "1111111" } } } |
FAQs
When do managers get the BetterUp email?
When a Peakon survey round is hard-closed and results are available to managers.
Which managers get the email?
Managers who qualify to see Peakon results and have BetterUp access. See Member experience for where each email leads.
What data does Peakon send to BetterUp?
Survey start and close events, plus the email, direct report count, and Workday ID of each qualifying manager. See Security.
I lost the Webhook Secret. What now?
Contact your Implementation manager directly, or email tech-ipm@betterup.co for assistance.
Questions? Contact tech-ipm@betterup.co or your BetterUp implementation contact.
Jump to: Features | Roles and responsibilities | Configuration and setup | Integration feature detail | Security | FAQs