Preview · Reviewed 2026-10-08
Preview: implemented and tested with fixtures; endpoints verified against a live account.
Before you start
- A Fivetran account and an Account Administrator who can create System Keys.
Read-only permissions
Create a System Key with READ access only:
| Read scope | Used for |
|---|---|
| USER | Users, account role, active and invited state, last sign-in. |
| TEAM | Teams, their members and the roles a team grants. |
| ROLES | Role names and scope, used to rate each role low to critical. |
| DESTINATION (optional) | Destination memberships and destination names. |
| CONNECTOR (optional) | Connection memberships and connection names. |
Never grant MANAGE on any scope. Record the key owner and rotate the secret on schedule.
Connect Fivetran
- In Fivetran, create a System Key with the READ scopes above.
- Copy the API key and API secret.
- In KeySkope, open Data sources → Add data source → Fivetran, enter both values and save. The first sync starts straight away.
Connection fields
| Setting | Purpose / value |
|---|---|
| api_key | System Key API key. |
| api_secret | System Key API secret. Stored per tenant in the secret store; never shown again and never logged. |
What appears in KeySkope
- Every user with their account role, active and invited state, and last sign-in (Fivetran returns it for every user, so no sign-in means never signed in).
- Destination and connection memberships, held directly or through a team, with the team named as the source.
- Roles rated low to critical; Account Administrator is critical.
- Flags: account administrators, destination creators, never signed in, stale sign-in, pending invitations, service accounts and privileged API keys.
- Without DESTINATION and CONNECTOR read, memberships show as permission denied and nothing already recorded is removed.
- Whether a user signs in with SSO is not reported by the API, so KeySkope does not guess it.
Verify the first sync
- Check that Accounts, Roles and Activity show complete.
- Compare the user count and one administrator’s role with Fivetran’s Users page.
Troubleshooting
| Symptom | Cause / fix |
|---|---|
| 401 | Wrong API key or secret, or the key was deleted. |
| Roles: permission denied | Add DESTINATION and CONNECTOR READ to see memberships. |
| Names missing | Without DESTINATION / CONNECTOR read, memberships show by ID. |