Skip to main content

Updated Oct 31, 2026Verified against the product Oct 31, 2026

Set Up SSO with Okta

Single sign-on lets your team sign in with your identity provider, and FunnelStory maps your IdP groups to its roles so people land with the right access. This guide walks setting it up with Okta (SAML) end to end — including the group-to-role mapping and the resync step that trips people up. The full reference is SSO.

Before you start​

  • You'll need the Admin or Super Admin role in FunnelStory, and admin access in Okta.

1. Create the SAML app in Okta​

Create a SAML application and point it at FunnelStory:

  • Single sign-on / ACS URL: https://app.funnelstory.ai/api/auth/sso/callback
  • Email attribute: send the user's email, which FunnelStory uses to identify the user.

2. Map Okta groups to FunnelStory roles​

FunnelStory's roles are super_admin, admin, data_admin, manager, and account_user. Map each Okta group to the role its members should get. If a user matches several mappings, the highest role wins — so a user in both an admin group and a user group becomes an admin.

3. Test with a pilot user​

Sign in as a test user in one of the mapped groups and confirm they land with the expected role before rolling out to everyone.

4. Resync after you change mappings​

When you change a group-to-role mapping, existing users don't pick up the change at their next login automatically. On a SAML workspace, an Admin or Super Admin can click Resync SSO roles to re-apply the current mappings to everyone. (A user's manually-set role is preserved where applicable — see SSO for the exact behavior.)