Skip to main content

​
Import Existing Statsig Teams

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

​
Setup

  • 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, you should see the group 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, you must first create a mapping group.
  • This group will contain the Okta members which will be 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. It should follow the format Statsig-ProjectName-TeamName-RoleName.
Match result settings linking Okta group to Statsig-Project-Team role name
  1. When you are finished setting up the push, click “Save”.

​
Verify the Push

  • Navigate to the Statsig Project and verify that the team has the new members.
  • This could take some time for Okta to push the 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, the team should be deleted from Statsig. This may take a few minutes to complete.
Confirmation dialog asking to delete pushed group from app

​
Optional: Create a Team Via 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 are finished setting up the push, click “Save”.
  • Afterwards, you should see the new team in the Statsig Project you specified.
Statsig console showing newly created team populated from SCIM push