Step 1b: Create Destination Environment

POST {{apiPath}}/environments

Create the destination environment using a POST {{apiPath}}/environments request. It's important to note that this is your destination PingOne environment, which acts as the service provider (SP) for the OIDC application. You'll use this environment to configure the OIDC IdP connection. Authentication flows in this environment can be configured to allow external authentication.

  • In the request body, the name, region, and type attributes are required.

  • The value of the name attribute must be unique within the organization.

The response returns an environment ID that you'll use in the next steps.

See Create Environment for more information.

Request Body

{"name"=>"Destination_Environment_{{$timestamp}}", "description"=>"New destination environment", "type"=>"SANDBOX", "region"=>"NA", "billOfMaterials"=>{"products"=>[{"type"=>"PING_ONE_BASE", "description"=>"New destination environment product description", "console"=>{"href"=>"https://example.com"}}]}, "license"=>{"id"=>"{{licenseID}}"}}

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring
Content-Typestring