Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Identity Hub
    • All guides
    • Subscribing a user to notifications
      • Creating a user pool
      • Updating a user pool
      • Setting up a domain in a user pool
      • Getting a list of user pools
      • Getting information about a user pool
      • Getting a list of users in a pool
      • Setting up access to a user pool
      • Deleting a user pool
  • Access management
  • Pricing policy
  • Terraform reference
  • Audit Trails events
  • Release notes
  1. Step-by-step guides
  2. Managing user pools
  3. Creating a user pool

Creating a user pool

Written by
Yandex Cloud
Updated at November 10, 2025

Note

This feature is at the Preview stage.

Cloud Center UI
CLI
  1. Log in to Yandex Identity Hub.

  2. In the left-hand panel, select User pools.

  3. In the top-right corner of the page, click Create user pool.

  4. Enter a name and description for the user pool.

    The name must be unique within the organization and aligned with the naming requirements:

    • It must be from 1 to 63 characters long.
    • It may contain lowercase Latin letters, numbers, and hyphens.
    • It must start with a letter and cannot end with a hyphen.
  5. In the Default domain field, add the domain that will be used if there are no other domains associated with the pool.

  6. Optionally, add labels:

    1. Click Add label.
    2. Enter a label in key: value format.
    3. Press Enter.
  7. Click Create userpool.

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

  1. See the description of the CLI command for creating a user pool:

    yc organization-manager idp userpool create --help
    
  2. Run this command:

    yc organization-manager idp userpool create \
      --organization-id <organization_ID> \
      --userpool-name <pool_name> \
      --description <pool_description> \
      --default-subdomain <default_domain> \
      --labels <key>=<value>[,<key>=<value>]
    

    Where:

    • --organization-id: ID of the organization you want to create a user pool in.

    • --userpool-name: User pool name. The name must be unique within the organization and aligned with the naming requirements:

      • It must be from 1 to 63 characters long.
      • It may contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.
    • --description: User pool description. This is an optional parameter.

    • --default-subdomain: Default domain. It will be used if no other domains are associated with the pool.

    • --labels: List of labels. This is an optional parameter. You can specify one or more labels separated by commas in <key1>=<value1>,<key2>=<value2> format.

See alsoSee also

  • Add local users
  • Associating a domain

Was the article helpful?

Previous
Setting up a domain in an identity federation
Next
Updating a user pool
© 2025 Direct Cursus Technology L.L.C.