On this page

Okta SCIM Team Management

Manage Statsig teams from Okta using SCIM provisioning so team membership stays in sync with Okta groups and reflects organizational changes automatically.

Import existing Statsig teams

Teams are specific Statsig groups that exist within projects. They aren't shared across projects. They also have two possible roles: Admin and Member.

Before you begin

  • Ensure you have some teams created in Statsig.
  • Navigate to the Statsig Project and create a team if you have none.

Statsig project team creation dialog showing fields for team name and members

Import existing groups

  • In Okta, go to the Statsig app's "Import" tab
  • Click "Import Now" to fetch existing Statsig users, groups, and teams
  • After importing, the group appears in your Okta groups following the format Statsig-ProjectName-TeamName-RoleName.

Okta Import tab displaying Statsig team groups discovered from SCIM

Create a mapping group

  • To push a group of Okta users to a Statsig team, first create a mapping group.
  • This group contains the Okta members who are part of the Team x Role Group.

Okta group creation screen for mapping Statsig team members

Push teams to Statsig

  1. In Okta, go to the Statsig Integration's "Push Teams" tab and select "Push Groups". Then pick the mapping group created in the previous step.

    Okta Push Groups dialog selecting mapping group to link with Statsig team

  2. Change the Match result & push action to Link group. Then select the Statsig team you want to push to. The team name must follow the format Statsig-ProjectName-TeamName-RoleName.

Match result settings linking Okta group to Statsig-Project-Team role name

  1. When you finish setting up the push, click Save.

Verify the push

  • Navigate to the Statsig Project and verify that the team has the new members.
  • Okta can take a few minutes to push members to the team.

Statsig team detail page showing synced Okta members

Delete the team

  • On Okta, navigate to push groups and find the pushed group that maps to the Statsig team.
  • Click the push status section and select "Unlink Group".

Okta push groups status view with unlink group option

  • When prompted to delete the group or leave it in the app, select "Delete".
  • After Okta pushes the deletion, Statsig deletes the team. This can take a few minutes to complete.

Confirmation dialog asking to delete pushed group from app

Optional: Create a team using SCIM

  • Find an existing Okta group with the members for a new Statsig Team.
  • Navigate to Push Groups and Select "Push Groups".
  • Select the group you want to push to Statsig.
  • Change the Match result & push action to Create Group.
  • The naming for this group must match the format Statsig-ProjectName-TeamName-Member.

Okta push groups workflow set to create new Statsig team group

  • When you finish setting up the push, click Save.
  • The new team appears in the Statsig Project you specified.

Statsig console showing newly created team populated from SCIM push

Was this helpful?