Kisi Door Access
Link your Kisi door-access account: store the API key, test the connection, sync Kisi members into the app, see how they are matched to athletes by email, and resolve unmatched members by hand.
Overview
Kisi is a door-access system. The Kisi integration pulls the member list from your Kisi account into Connected Performance and matches each Kisi member to an athlete, so you can see which athletes hold a door credential and fix the ones Kisi could not identify.
The sync is one-way and read-only on the Kisi side: the app reads members from Kisi and never creates, edits or removes anything in Kisi.
Admins only. The integration appears once Kisi is enabled for your organization; if you do not see a Kisi tab under My App > Settings, contact support to have it switched on.
How To
Store the Kisi API key
- Go to My App > Settings and open Kisi under Integrations.
- Paste your key into Kisi API key.
- Click Test connection. The app calls Kisi with the key you typed, before saving it. You see "Kisi connection succeeded." or "Could not connect to Kisi. Verify the Kisi API key and service availability, then try again."
- Click Save changes.
The key is stored encrypted. The field is a password input and the saved value is not shown back in clear text. Test connection uses the key in the field if you changed it, otherwise the stored key.
Open the Kisi Members page
Click Manage Kisi members on the Kisi settings tab, or go to /app/kisi-members. The page is not in the sidebar. It shows the heading Kisi members and the time of the last completed sync.
If you are not an admin the page shows "Only organization administrators can manage Kisi members." If the feature is off it shows "Kisi is not enabled for this organization."
Run a sync
Click Sync now. Opening the page also starts a sync automatically if the last completed one finished more than an hour ago.
What a sync does:
- Reads every member from Kisi, 100 at a time. Rows without an id, email and name are skipped and counted as malformed.
- For each Kisi member, creates or updates the member record in the app with the Kisi id, email and name, marks it active, and records when it was last seen.
- Matches the member to an athlete (see the rules below). Members you assigned manually keep their assignment.
- Marks any previously active member that no longer appears in Kisi as inactive. Nothing is deleted.
- Records the run.
Only one sync runs at a time per organization. Starting a second one while the first is still running fails with "A Kisi member sync is already running for this organization". Syncing stops with an error if the Kisi account holds more than 20,000 members.
When the sync finishes, the page shows a summary: "Last run: N processed, N created, N matched, N unmatched members", plus "N malformed members skipped" and "N members marked inactive" when those counts are non-zero. A failed run shows its error message.
Understand matching
The sync compares the Kisi member's email address, case-insensitively, with user emails in your organization:
| Match | Rule |
|---|---|
| Matched by athlete email | A user with that email is an athlete. The member is linked to that athlete. |
| Matched by parent email | A user with that email is a parent of exactly one athlete in your organization. The member is linked to that athlete. A parent of several athletes is not matched automatically. |
| Manually assigned | You assigned the athlete yourself. The sync never overrides this. |
| Unmatched | No user in your organization has that email, or the parent rule was ambiguous. |
Email matches are re-evaluated on every sync, so an athlete whose email you correct in the app is matched on the next run.
Assign an unmatched member to an athlete
- On the Kisi Members page, filter Match status to Unmatched if you like.
- Click Assign athlete on the member's row.
- Pick the athlete under Athlete and click Confirm assignment.
The member's match becomes Manually assigned and stays that way through future syncs. You can also re-assign a member that was matched by email; the manual choice then takes precedence. If the member or athlete cannot be found you see "Kisi member or athlete was not found."
Find members
Use the filters above the table:
| Filter | Options |
|---|---|
| Active status | Active members (default) or Inactive members |
| Match status | All matches, Matched by athlete email, Matched by parent email, Manually assigned, Unmatched |
| Search members | Name or email, partial match |
The table lists Name, Email, Status (Active or Inactive) and Match, sorted by name, 25 per page. Use Previous and Next to page. Changing a filter clears any row selection.
Delete members from the app
- Tick the checkbox on one or more rows. The bar shows "N members selected".
- Click Delete members.
- Confirm in the dialog with Delete members.
The dialog explains the consequence: "This only removes members from Connected Performance. They will reappear after the next Kisi sync." Nothing happens in Kisi. Up to 100 members can be deleted in one go. Use this to clear out inactive records; to stop someone reappearing, remove them in Kisi.
Tips
- Make athlete and parent emails in the app match the emails in Kisi. That is the only automatic matching rule, and it covers most members without manual work.
- Let the page's automatic sync do the routine work. It runs on open when the last sync is over an hour old, so Sync now is only needed right after a change in Kisi.
- Filter by Inactive members after a sync to see who lost access in Kisi; those records stay until you delete them.
- Assign manually only when the emails genuinely differ. A manual assignment is permanent and will not follow a later email correction.
Troubleshooting
"Could not connect to Kisi. Verify the Kisi API key and service availability, then try again." The key was rejected or Kisi did not respond. Check the key in your Kisi account, paste it again and click Test connection. Transient Kisi errors are retried three times before the test gives up.
"Kisi sync failed." or "Could not sync Kisi members." The run is recorded as failed with the reason shown in the summary banner. Usual causes: the API key is missing or invalid, Kisi returned an unexpected response, or the account exceeds 20,000 members.
"A Kisi member sync is already running for this organization." Another admin, or the automatic sync on page open, is mid-run. Wait for it to finish and the page will refresh.
A member shows as Unmatched although the athlete exists. The athlete's email in the app does not equal the member's email in Kisi. Fix the email on the athlete's account and sync again, or use Assign athlete.
A parent's member record is Unmatched. The parent is linked to more than one athlete in your organization, so the sync cannot pick one. Assign it manually.
A deleted member came back. Expected. Deleting only removes the record in the app; the next sync re-imports anyone still in Kisi.
The Kisi tab is not in Settings. Kisi is not enabled for your organization. Contact support.
Related
- Organization Settings
- Managing Athletes & Groups
- How To Manage Users
Referenced by
- 'Organization Settings'getting started