VALD Integration
Connect a VALD ForceDecks or DynaMo account, link VALD profiles to athletes, pull tests into Connected Performance, and read the force-time curve and metrics of each test.
Overview
The VALD integration pulls ForceDecks and DynaMo tests from your VALD tenant into Connected Performance. Each test is stored against the athlete whose VALD profile it belongs to, so staff can browse tests per athlete, read every metric VALD recorded, and chart the force-time curve. A Vald Forceplate exercise type lets a workout pull reps straight from ForceDecks while an athlete trains.
The integration is off by default. An admin turns it on and enters the organization's VALD credentials. There is no scheduled sync: tests arrive when someone clicks Sync.
How To
Turn the integration on
- Ask Connected Performance support to enable the Vald feature for your organization. The feature switch is not on the admin settings page.
- Go to My App > Settings and open the Vald tab (admins only).
- Enter Vald Username, Vald Password and Vald Duende ID. The tab says where to find them: your Vald Hub account. They are stored encrypted.
- Save. Once a username and password are present the tab shows "Vald credentials are configured. Athlete profiles will show the Vald profile mapper."
Discover your tenant
Before the first sync, Connected Performance has to find your VALD tenant and region. That is the job of the connection test, POST /api/vald/test-connection (staff). It logs in with the saved credentials, tries the aue, use and euw regions in turn, and stores the first tenant it finds. Until it has run, sync fails with Vald tenant not discovered. Run test-connection first.
There is no button for this in Settings. Run it against the API (see API Access for Developers) or ask support to run it for you. The result is either connected: true with the tenant name and region, or one of:
| Error | Meaning |
|---|---|
Authentication failed — check client ID and secret | VALD rejected the credentials. Re-enter them and retry. |
No tenants found in any region. Verify your Vald credentials. | Login worked but no tenant was visible in any region. |
Vald integration is not enabled for this organization | The Vald feature toggle is off. |
Vald credentials not configured for organization | Username or password is missing in the Vald tab. |
Link a VALD profile to an athlete
Tests are matched to athletes through the VALD profile id saved on the athlete.
- Open the athlete under Athletes. With the feature on, the profile shows a Vald Profile box ("Link this athlete to their Vald ForceDecks profile.").
- Pick a profile from Select Vald profile.... Profiles whose name matches the athlete's name are listed first and marked "suggested".
- Click Link. The box switches to a Linked badge with the VALD name and an Unlink button.
Linking is staff only. Sync also links automatically: a VALD profile whose given and family name equal the athlete's name (case-insensitive) is attached to that athlete the first time a sync sees it. Tests for profiles that match nobody are still imported, with no athlete, and only staff can see them.
If the dropdown says "No Vald profiles found. Check credentials in Settings → Integrations → Vald.", the tenant has not been discovered or the credentials are wrong.
Sync tests
- Open
/app/vald(all athletes) or/app/vald/:athleteId(one athlete). The page is titled Vald Tests. - Click Sync. The button reads Syncing... until the pull finishes, then a toast says
Synced N tests (M skipped).
What a sync does:
- Pulls ForceDecks tests modified since the last sync, and every DynaMo test. Tests already imported are skipped, not updated.
- Attaches each test to the athlete mapped to its VALD profile.
- For every Vald Forceplate exercise that has a Primary Metric, writes one logged exercise per matching test (same athlete, date and value are never written twice). Those rows show up in the athlete's exercise history.
Staff and athletes can trigger a sync. An athlete does it from a tracked workout with Sync Rep (below).
Browse tests
The list is newest first. Filter with the type dropdown: All Types, CMJ, Isometric, Drop Jump, Squat Jump, Hop, Hamstring, Grip, Custom. Each card shows the test type, the athlete, the date and the first four metrics. An empty list reads "No tests found".
Staff on /app/vald see every test in the organization, including unmapped ones. An athlete sees only their own tests.
Click a card to open /app/vald/:athleteId/:testId:
- Force-Time Curve: the ForceDecks recording, or the DynaMo trace. It is fetched once and then cached on the test.
- Metrics: every value VALD returned for the test, three decimals. "No metrics available" means VALD sent none.
Use ForceDecks inside a workout
- In Libraries > Exercise Library, create or edit an exercise and set its type to Vald Forceplate. A Vald Metric Configuration section appears.
- Optionally set Test Type Filter (e.g. CMJ, SJ, ISO) and Source Filter (Both (ForceDecks + DynaMo), ForceDecks only, DynaMo only).
- Type in Primary Metric to search the ForceDecks result definitions and pick one. The unit is filled in from the definition. Clear removes it.
- Add the exercise to a workout.
When an athlete tracks that workout, the exercise shows a Live ForceDecks Session panel. Each click on Sync Rep runs a sync and adds any ForceDecks test that did not exist when the page opened as the next rep. The panel charts Jump Height, Peak Force, RSI-mod, Peak Power and Asymmetry per rep, with toggles per metric, and a Latest summary. If the athlete is not yet linked, a compact mapper ("Link to Vald profile to sync data") appears above the panel. The completed workout later shows the same reps as a ForceDecks Session chart and table.
Delete a test
There is no delete button in the app. DELETE /api/vald/tests/:id removes an imported test; the caller needs write access to the test's athlete, which means staff of that athlete's organization. A deleted DynaMo test comes back on the next sync. A deleted ForceDecks test comes back only if VALD modifies it after your last sync.
Who can do what
| Action | Athlete | Parent | Staff (coach, admin) |
|---|---|---|---|
| Enter credentials, enable feature | No | No | Admin only |
| Test connection, list profiles | No | No | Yes |
| Link or unlink a profile | No | No | Yes |
| Sync | Yes | No | Yes |
| View tests and recordings | Own only | No | Any athlete in org |
| View unmapped tests | No | No | Yes |
Tips
- Run the connection test right after saving credentials. Nothing else works until a tenant is stored.
- Name athletes in Connected Performance exactly as they are named in VALD and most profiles link themselves on the first sync.
- Sync before a review session. Nothing runs in the background, so the list is only as fresh as the last click on Sync.
- Set a Primary Metric on your Vald Forceplate exercises if you want VALD results in exercise history, reports and leaderboards. Without it, tests are visible under Vald Tests only.
- The VALD login token is cached for 23 hours. Changing credentials takes effect at the next connection test, which clears the cache.
Troubleshooting
Sync fails with "Vald sync failed". Usually the tenant has not been discovered yet. Run the connection test, then sync again.
The athlete's tests show up on /app/vald with no name.
The VALD profile is not linked to an athlete. Link it on the athlete profile, then sync. Tests imported before the link stay unassigned.
"No Vald profiles found" on the athlete profile. The profile list comes from VALD at view time. Check the feature toggle, the credentials and that the connection test succeeded.
Sync Rep adds nothing during a workout. Only ForceDecks tests count as reps, and only tests that did not exist when the exercise was opened. Make sure the rep was recorded in VALD before clicking, and that the athlete is linked.
The Vald tab is missing in Settings. Only admins see it, and only after the Vald feature is enabled for your organization by support.
Related
- Exercise Library - Managing Exercises
- Tracking a Workout (Athletes)
- Completed Workouts & Exercise History
- Manage Your Settings
- API Access for Developers
Referenced by
- 'Completed Workouts & Exercise History'workouts
- 'Organization Settings'getting started