Step 5: Create a population

POST {{apiPath}}/environments/{{envID}}/populations

This example shows the POST /environments/{{envID}}/populations operation to create a new population. All users in PingOne must be associated with a population. Although your new environment automatically includes a default population, creating a new population gives you the ability to associate this user with a more specific population grouping.

In this request:

  • The request URL to create a population needs the environment ID ({{envID}}) you created in the prior step.

  • The request body requires a value for the name property. The description property is optional.

  • The request returns a Status: 201 created message and shows the new population's configuration data.

  • The response data includes the population's id property. The population ID is needed to create the new user in the next step.

See the following topics to learn more about populations:

Request Body

{"name"=>"dvFlowPopulation_{{$timestamp}}", "description"=>"Population for a PingOne journey"}

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring
Content-Typestring