---
title: Getting started
description: The following provides guidance on preparing a PingOne tenant for Terraform access.
component: terraform
page_id: terraform::products/pingone/getting_started
canonical_url: https://developer.pingidentity.com/terraform/products/pingone/getting_started.html
revdate: March 19, 2025
section_ids:
  requirements: Requirements
  pingone-subscription-or-trial: PingOne subscription or trial
  configure-pingone-for-terraform-access: Configure PingOne for Terraform access
  finding-required-ids: Finding required IDs
  license-id-organization-id-and-organization-name: License ID, organization ID, and organization name
---

# Getting started

The following provides guidance on preparing a PingOne tenant for Terraform access.

## Requirements

* Terraform CLI 1.4+

* A licensed or trial PingOne cloud subscription. [Try Ping here.](https://www.pingidentity.com/en/try-ping.html)

* Administrator access to the [PingOne admin console](https://docs.pingidentity.com/pingone/managing_your_pingone_user_profile/p1_signin.html).

## PingOne subscription or trial

To get started using the PingOne Terraform provider, you must first have an active PingOne cloud subscription. Get instant access with a [PingOne trial account](https://www.pingidentity.com/en/try-ping.html) or read more about Ping Identity at [pingidentity.com](https://www.pingidentity.com)

## Configure PingOne for Terraform access

The PingOne Terraform provider requires the ability to connect to the PingOne Management APIs through the use of a worker application that has administrative roles assigned.

The following steps describe how to connect Terraform to your PingOne instance using a worker application:

1. Sign on to your PingOne admin console. When you register for a trial, a link will be sent to your provided email address.

2. Open the **Administrators** environment. Note that any environment can be used.

3. Go to **Applications**.

   > **Collapse: Expand Screenshot**
   >
   > ![PingOne Administration Console](../../_images/products/pingone/getting_started/pingone-console-environment-home-applications.png)

4. Click the **+** icon to add a new application.

   > **Collapse: Expand Screenshot**
   >
   > ![PingOne admin console](../../_images/products/pingone/getting_started/pingone-console-applications-home.png)

5. Enter a name and an optional description, and ensure that **Worker** is selected as the application type.

   > **Collapse: Expand Screenshot**
   >
   > ![PingOne admin console](../../_images/products/pingone/getting_started/pingone-console-add-application.png)

6. Click the toggle to enable the application.

   > **Collapse: Expand Screenshot**
   >
   > ![PingOne admin console](../../_images/products/pingone/getting_started/pingone-console-application-settings.png)

7. On the **Roles** tab, set the administrative roles accordingly.

   The following image shows example roles to be able to create and manage environments and their configurations. You can find more information about role permissions in [Administrator Roles](https://docs.pingidentity.com/pingone/directory/p1_roles.html) in the PingOne documentation.

   > **Collapse: Expand Screenshot**
   >
   > ![PingOne admin console](../../_images/products/pingone/getting_started/pingone-console-application-roles.png)

8. On the **Configuration** tab, expand the **General** section and copy the **Client ID**, **Client Secret**, and **Environment ID** values. These IDs are used to authenticate the provider to your PingOne tenant.

   > **Collapse: Expand Screenshot**
   >
   > ![PingOne admin console](../../_images/products/pingone/getting_started/pingone-console-application-details.png)

9. You can find the steps to configure the PingOne Terraform provider using these values in the [Terraform Registry provider documentation](https://registry.terraform.io/providers/pingidentity/pingone/latest/docs).

## Finding required IDs

There are tenant specific, unique IDs and name values that are required for the provider to operate. The following sections show how to retrieve the relevant IDs.

### License ID, organization ID, and organization name

The license ID is required when creating an environment using the [`pingone_environment` resource](https://registry.terraform.io/providers/pingidentity/pingone/latest/docs/resources/environment).

The organization ID and organization name can be used with the [`pingone_organization` data source](https://registry.terraform.io/providers/pingidentity/pingone/latest/docs/data-sources/organization). These values can be found with the following steps:

1. Sign on to the PingOne admin console using your unique console link.

2. Go to **Licenses**.

   > **Collapse: Expand Screenshot**
   >
   > ![PingOne admin console](../../_images/products/pingone/getting_started/pingone-console-admins-licenses.png)

3. Look for the relevant license (that's not an Admin license) and click the **Copy link** icon to copy the ID. The organization name and organization ID are also shown and can be copied.

   > **Collapse: Expand Screenshot**
   >
   > ![PingOne admin console](../../_images/products/pingone/getting_started/pingone-console-admins-licenses-detail.png)