In PingOne, a population defines a set of users, similar to an organizational unit (OU). In a given environment, you can use populations to simplify the management of users. For example, you can create a population for similar types of users and apply a password policy to that population.

The populations endpoints implement functions to create, read, update, delete, and search for population resources within a specified environment. You must create at least one population before you can create users. An individual user cannot belong to more than one population simultaneously, but users can be moved to a different population.

Populations data model

Property Description
createdAt The time the resource was created.
description A string that specifies the description of the population.
environment.id A string that specifies the environment resource’s unique identifier associated with the population.
id A string that specifies the resource’s unique identifier.
name A string that specifies the population name, which must be provided and must be unique within an environment.
updatedAt The time the resource was last updated.
userCount The number of users that belong to the population. This is a read-only property.

Response codes

Code Message
200 Successful operation.
201 Successfully created.
204 Successfully removed. No content.
400 The request could not be completed.
401 You do not have access to this resource.
404 The requested resource was not found.