> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PingOne

> How to set up the PingOne connector, plus the actions and events that are available.

![PingOne](https://stackone-logos.com/api/pingone/filled/svg)

Previewv2.0.0[See changelog](https://docs.stackone.com/connectors/pingone/changelog.md)

[124 actions](#actions) · [42 events](#events) · 2 auth methods

IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/pingone/guides/connector-profile/oauth-2-0.md)
>
> Delegated admin access using OAuth 2.0 Authorization Code. An administrator signs in to PingOne, and the connector acts...

> [card] [OAuth 2.0 (Client Credentials) · Connector Profile](https://docs.stackone.com/connectors/pingone/guides/connector-profile/oauth-2-0-client-credentials.md)
>
> App-only access without a signed-in user. Requires a PingOne Worker application with the Client Credentials grant, and a...

Optionally, configure receiving Events for PingOne into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/pingone/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/pingone/guides/link-account/oauth-2-0.md)

> [card] [OAuth 2.0 (Client Credentials) · Link Account](https://docs.stackone.com/connectors/pingone/guides/link-account/oauth-2-0-client-credentials.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

OAuth 2.0

OAuth 2.0 (Client Credentials)

No auth methods found

Scopes

Select all
|
Clear

openid

No scopes found

124 actions

ActionDescriptionRequired scopes

List Certificates`pingone_list_certificates`

List all X.509 certificates imported into the PingOne environment's certificate store.

Import Certificate`pingone_import_certificate`

Upload a base64-encoded PEM X.509 certificate into the PingOne certificate store as SIGNING or ENCRYPTION usage.

List Populations`pingone_list_populations`

List every population (user segment) in the PingOne environment with optional SCIM filtering and cursor pagination.

Get Population`pingone_get_population`

Retrieve one population by its PingOne ID, including its associated password policy and user count.

Create Population`pingone_create_population`

Create a new population (user segment) in the PingOne environment with an optional default flag and password policy.

Update Population`pingone_update_population`

Replace a population's name, description, default flag, and password policy via full PUT replacement.

Delete Population`pingone_delete_population`

Permanently delete a population. The population must be empty (no assigned users) before deletion.

Get Population Default Identity Provider`pingone_get_population_default_idp`

Retrieve the default identity provider assigned to a population for sign-on flows.

Update Population Default Identity Provider`pingone_update_population_default_idp`

Set or replace the default identity provider for a population so its users authenticate via that IdP by default.

Get Current User Info`pingone_get_current_user_info`

Retrieve OIDC profile claims (sub, email, name, etc.) for the user represented by the current access token via the PingO...

`openid`

List Users`pingone_list_users`

List users in the PingOne environment with SCIM filtering, cursor pagination, and configurable page size.

Get User`pingone_get_user`

Retrieve one PingOne user by ID, optionally expanded with their group membership IDs or names.

Create User`pingone_create_user`

Create a PingOne user with profile attributes, address, optional initial password, and population assignment.

Update User`pingone_update_user`

PATCH update specific attributes of a user without replacing the full resource.

Delete User`pingone_delete_user`

Permanently delete a user and all of their associated data from the environment. Irreversible.

Get User Enabled Status`pingone_get_user_enabled`

Check whether a user account is enabled (can sign in) or disabled.

Update User Enabled Status`pingone_update_user_enabled`

Enable or disable a user account (disabled users cannot sign in).

Get User Password Metadata`pingone_get_user_password`

Retrieve password-state metadata for a user (status, last-change timestamp, external-management flag) — never the passwo...

Set User Password`pingone_set_user_password`

Administratively set a new password for a user without requiring their current password.

Get User Population`pingone_get_user_population`

Retrieve the population a user currently belongs to.

Update User Population`pingone_update_user_population`

Move a user to a different population, switching the password and sign-on policies that apply to them.

List User Groups`pingone_list_user_groups`

List every group the user is a member of, including groups inherited through nested group membership.

Add User To Group`pingone_add_user_to_group`

Add a user as a direct member of a group so they inherit that group's role and policy assignments.

Get User Group Membership`pingone_get_user_group_membership`

Check whether a user is a member of a specific group and return the membership record.

Remove User From Group`pingone_remove_user_from_group`

Remove a user's direct membership from a group and revoke the associated inherited role/policy assignments.

List User Role Assignments`pingone_list_user_role_assignments`

List every admin role assigned directly to a user with its scope type and scope ID.

Create User Role Assignment`pingone_create_user_role_assignment`

Grant an admin role directly to a user at a specific scope (organization, environment, or population).

Get User Role Assignment`pingone_get_user_role_assignment`

Retrieve one role assignment on a user, including the role reference and scope details.

Delete User Role Assignment`pingone_delete_user_role_assignment`

Revoke a specific admin role assignment from a user, removing the permissions it granted.

Get User Identity Provider`pingone_get_user_identity_provider`

Retrieve the external identity provider currently linked to a user.

Update User Identity Provider`pingone_update_user_identity_provider`

Link or re-link a user to an external identity provider, replacing any previous IdP association.

Get User Verify Status`pingone_get_user_verify_status`

Retrieve the current PingOne Verify identity-verification status for a user.

Update User Verify Status`pingone_update_user_verify_status`

Programmatically set the PingOne Verify identity-verification status on a user.

Get User Activities`pingone_get_user_activities`

Retrieve environment-wide user activity metrics (sign-ons, MFA usage, behavioral counters) aggregated across users.

List Groups`pingone_list_groups`

List all groups in the PingOne environment with SCIM filtering and cursor pagination.

Create Group`pingone_create_group`

Create a new group (static or dynamic) with optional population scoping, userFilter, external ID, and custom data.

Get Group`pingone_get_group`

Retrieve one group by ID, optionally including total member counts.

Update Group`pingone_update_group`

Replace a group's name, description, userFilter, external ID, and custom data via full PUT replacement.

Delete Group`pingone_delete_group`

Permanently delete a group. All current members and role assignments are dropped automatically.

List Group Nested Groups`pingone_list_group_nested_groups`

List all parent groups that contain this group as a nested (child) member.

Add Group To Group`pingone_add_group_to_group`

Nest this group inside a parent group so its members inherit the parent's role and policy assignments.

Get Group Nested Group`pingone_get_group_nested_group`

Retrieve a single nested-group relationship record between a child group and a specific parent group.

Remove Group From Group`pingone_remove_group_from_group`

Break the nested-group relationship between a child group and its parent group (groups themselves are not deleted).

List Group Role Assignments`pingone_list_group_role_assignments`

List admin role assignments attached to a group (members inherit these permissions).

Create Group Role Assignment`pingone_create_group_role_assignment`

Grant an admin role to every member of a group at a specified scope (organization, environment, or population).

Get Group Role Assignment`pingone_get_group_role_assignment`

Retrieve one admin role assignment attached to a group, including its role and scope.

Delete Group Role Assignment`pingone_delete_group_role_assignment`

Revoke an admin role assignment from a group. All members lose the permissions they inherited through it.

List Applications`pingone_list_applications`

List every application (OIDC, SAML, Worker, External Link, etc.) registered in the PingOne environment.

Create Application`pingone_create_application`

Register a new OIDC, SAML, Worker, or external-link application with protocol-specific configuration.

Get Application`pingone_get_application`

Retrieve a single application with its full protocol-specific configuration.

Update Application`pingone_update_application`

Replace the full configuration of an existing application via PUT (name, enabled, protocol, type required).

Delete Application`pingone_delete_application`

Permanently delete an application and all of its dependent configuration (grants, attributes, assignments, secrets).

Get Application Secret`pingone_get_application_secret`

Retrieve the current (and previous, if any) client secret for an OIDC application.

Generate Application Secret`pingone_generate_application_secret`

Rotate the client secret for an OIDC application, preserving the previous secret for graceful migration.

Delete Application Secret`pingone_delete_application_secret`

Retire the previous (rotated-out) client secret so only the current secret remains usable.

List Application Grants`pingone_list_application_grants`

List every resource grant attached to an application (which API resources it can call and with which scopes).

Create Application Grant`pingone_create_application_grant`

Grant an OAuth application access to a specific API resource with a set of scopes.

Get Application Grant`pingone_get_application_grant`

Retrieve one resource grant on an application, including its resource and scope details.

Update Application Grant`pingone_update_application_grant`

Replace the scopes on a resource grant (resourceId and at least one scope are both required).

Delete Application Grant`pingone_delete_application_grant`

Remove a resource grant, revoking the application's access to that API resource and its scopes.

List Application Sign-On Policy Assignments`pingone_list_app_sign_on_policy_assignments`

List the sign-on policies attached to an application, in evaluation priority order.

Create Application Sign-On Policy Assignment`pingone_create_app_sign_on_policy_assignment`

Attach a sign-on policy to an application at a given evaluation priority.

Get Application Sign-On Policy Assignment`pingone_get_app_sign_on_policy_assignment`

Retrieve one sign-on policy assignment on an application (policy reference and priority).

Update Application Sign-On Policy Assignment`pingone_update_app_sign_on_policy_assignment`

Replace the referenced policy and/or priority on an existing sign-on policy assignment.

Delete Application Sign-On Policy Assignment`pingone_delete_app_sign_on_policy_assignment`

Detach a sign-on policy from an application (the policy itself is not deleted).

List Application Role Assignments`pingone_list_app_role_assignments`

List admin role assignments on an application (typically Worker Apps using Client Credentials).

Create Application Role Assignment`pingone_create_app_role_assignment`

Grant a Worker App an admin role at a specific scope (organization, environment, or population).

Get Application Role Assignment`pingone_get_app_role_assignment`

Retrieve one admin role assignment on an application, including its role and scope.

Delete Application Role Assignment`pingone_delete_app_role_assignment`

Revoke an admin role from a Worker App, removing its permissions at the assignment's scope.

List Application Attributes`pingone_list_app_attributes`

List the application's attribute mappings (OIDC custom claims or SAML assertion attributes).

Create Application Attribute`pingone_create_app_attribute`

Add an OIDC custom claim or SAML assertion attribute mapping to an application.

Get Application Attribute`pingone_get_app_attribute`

Retrieve one attribute mapping on an application (claim/attribute name, expression, required flag).

Update Application Attribute`pingone_update_app_attribute`

Replace the name, value expression, and required flag of an existing attribute mapping.

Delete Application Attribute`pingone_delete_app_attribute`

Permanently remove an attribute mapping so it is no longer emitted in tokens or SAML assertions.

List System Roles`pingone_list_system_roles`

List every built-in (system-defined) admin role available at the PingOne organization level.

Get System Role`pingone_get_system_role`

Retrieve one built-in admin role with its full permission set and applicable scope types.

List Custom Roles`pingone_list_custom_roles`

List all custom (environment-scoped) admin roles defined in the connected PingOne environment.

Create Custom Role`pingone_create_custom_role`

Define a new custom admin role with a specific permission set and applicable assignment scopes.

Get Custom Role`pingone_get_custom_role`

Retrieve one custom admin role with its full permission set and applicable scopes.

Update Custom Role`pingone_update_custom_role`

Replace the name, description, permissions, and applicable scopes of a custom admin role via full PUT.

Delete Custom Role`pingone_delete_custom_role`

Permanently delete a custom admin role. All existing assignments of the role must be revoked first.

List Password Policies`pingone_list_password_policies`

List every password policy in the environment, including the default policy used when a population has none.

Get Password Policy`pingone_get_password_policy`

Retrieve one password policy with its full set of complexity, history, lockout, and expiry rules.

Create Password Policy`pingone_create_password_policy`

Create a new password policy with complexity, history, lockout, and age rules.

Update Password Policy`pingone_update_password_policy`

Replace the full configuration of a password policy via PUT (name plus the three exclusion flags are required).

Delete Password Policy`pingone_delete_password_policy`

Permanently delete a password policy. Populations using it fall back to the environment default.

List Identity Providers`pingone_list_identity_providers`

List every external identity provider (social and enterprise IdPs) configured in the environment.

Create Identity Provider`pingone_create_identity_provider`

Configure a new external identity provider (OIDC, SAML, or social) for federated authentication.

Get Identity Provider`pingone_get_identity_provider`

Retrieve one external identity provider with its full configuration (type, endpoints, credentials).

Update Identity Provider`pingone_update_identity_provider`

Replace the full configuration of an external identity provider via PUT (name, type, and enabled are required; type cann...

Delete Identity Provider`pingone_delete_identity_provider`

Permanently delete an external IdP. Linked users keep their accounts but lose the federation link.

List Identity Provider Attributes`pingone_list_idp_attributes`

List the attribute mappings that translate external IdP claims into PingOne user attributes at sign-on.

Create Identity Provider Attribute`pingone_create_idp_attribute`

Add an attribute mapping that assigns an external IdP claim to a PingOne user attribute.

Get Identity Provider Attribute`pingone_get_idp_attribute`

Retrieve one attribute mapping on an IdP (PingOne attribute name, external claim expression, update mode).

Update Identity Provider Attribute`pingone_update_idp_attribute`

Replace the name, value expression, and update behavior of an IdP attribute mapping.

Delete Identity Provider Attribute`pingone_delete_idp_attribute`

Remove an IdP attribute mapping so the associated external claim is no longer applied at sign-on.

List Sign-On Policies`pingone_list_sign_on_policies`

List every sign-on policy in the environment. Each policy defines an ordered authentication flow (login, MFA, agreement)...

Create Sign-On Policy`pingone_create_sign_on_policy`

Create an empty sign-on policy shell. Add policy actions and application assignments afterwards.

Get Sign-On Policy`pingone_get_sign_on_policy`

Retrieve one sign-on policy by ID (name, description, default flag, timestamps).

Update Sign-On Policy`pingone_update_sign_on_policy`

Replace a sign-on policy's name, description, and default flag. Policy actions are managed separately.

Delete Sign-On Policy`pingone_delete_sign_on_policy`

Permanently delete a sign-on policy. All application assignments referencing it must be removed first; the default polic...

List User MFA Devices`pingone_list_user_mfa_devices`

List every MFA device (TOTP, email, FIDO2, mobile, etc.) registered to a specific user with its status and type.

Pair User MFA Device`pingone_pair_user_mfa_device`

Start an MFA device pairing flow for a user (TOTP, FIDO2, EMAIL, or MOBILE).

Get User MFA Device`pingone_get_user_mfa_device`

Retrieve one MFA device record for a user (type, status, nickname, activation timestamp).

Delete User MFA Device`pingone_delete_user_mfa_device`

Permanently remove a registered MFA device from a user. The user must re-enroll to use that device type again.

Update User MFA Device Nickname`pingone_update_user_mfa_device_nickname`

Set or rename the user-facing nickname on an MFA device (e.g., "Work iPhone").

Get User MFA Enabled`pingone_get_user_mfa_enabled`

Check whether MFA is enabled for a user (disabled users skip all MFA actions in sign-on policies).

Update User MFA Enabled`pingone_update_user_mfa_enabled`

Enable or disable MFA for a user, overriding sign-on policy MFA requirements.

List Device Authentication Policies`pingone_list_device_auth_policies`

List every device authentication (MFA) policy — these configure which MFA methods users may use and how.

Create Device Authentication Policy`pingone_create_device_auth_policy`

Create a device authentication (MFA) policy with per-method enablement — all five methods (sms/email/mobile/totp/voice)...

Get Device Authentication Policy`pingone_get_device_auth_policy`

Retrieve one device authentication (MFA) policy with its full per-method configuration.

Update Device Authentication Policy`pingone_update_device_auth_policy`

Replace a device authentication (MFA) policy via full PUT — all five method enablement flags must be supplied.

Delete Device Authentication Policy`pingone_delete_device_auth_policy`

Permanently delete a device authentication (MFA) policy. The default policy cannot be deleted and all referencing sign-o...

Get Unified Credentials`pingone_unified_get_me`

Get the current PingOne connection's unified credentials and identity.

`openid`

List Unified Groups`pingone_unified_list_groups`

List unified groups in the connected PingOne environment.

Get Unified Group`pingone_unified_get_group`

Get a unified PingOne group by ID.

List Unified Organizations`pingone_unified_list_organizations`

List the PingOne environment associated with the current connection.

Get Unified Organization`pingone_unified_get_organization`

Get a unified PingOne environment by ID.

List Unified Resource Types`pingone_unified_list_resource_types`

List the resource\_type values unified\_list\_resource\_users accepts on this connector.

List Unified Resource Users`pingone_unified_list_resource_users`

List the PingOne users bound to a group or population, each with a resource-scoped role.

List Unified Roles`pingone_unified_list_roles`

List the built-in and custom PingOne admin roles available in the connected environment.

Get Unified Role`pingone_unified_get_role`

Get a unified PingOne admin role, built-in or custom, by ID.

List Unified Users`pingone_unified_list_users`

List unified users in the connected PingOne environment.

Get Unified User`pingone_unified_get_user`

Get a unified PingOne user by ID.

## Events

Tags

Select all
|
Clear

Applications

Certificates

Groups

Health Checks

Identity Providers

MFA

MFA Devices

Password Policies

Passwords

Populations

Role Assignments

Roles

Sign-On Policies

Users

No tags found

42 events

EventDescriptionTags

Active Check`pingone_active_check`

Responds with 200 OK to any PingOne webhook delivery that does not carry a recognized audit action type.

Health Checks

User Created`pingone_webhook_user_created`

Fired when a user is created in the environment in PingOne.

Users

User Updated`pingone_webhook_user_updated`

Fired when a user's attributes are updated in PingOne.

Users

User Deleted`pingone_webhook_user_deleted`

Fired when a user is deleted in PingOne.

Users

User Locked`pingone_webhook_user_locked`

Fired when a user account is locked in PingOne.

Users

User Unlocked`pingone_webhook_user_unlocked`

Fired when a locked user account is unlocked in PingOne.

Users

Password Set`pingone_webhook_password_set`

Fired when a user's password is set by an administrator or API call in PingOne.

Passwords

Password Reset`pingone_webhook_password_reset`

Fired when a user resets their password in PingOne.

Passwords

Group Created`pingone_webhook_group_created`

Fired when a group is created in PingOne.

Groups

Group Updated`pingone_webhook_group_updated`

Fired when a group is updated in PingOne.

Groups

Group Deleted`pingone_webhook_group_deleted`

Fired when a group is deleted in PingOne.

Groups

Member of Group Created`pingone_webhook_member_of_group_created`

Fired when a user or group is added as a member of a group in PingOne.

Groups

Member of Group Deleted`pingone_webhook_member_of_group_deleted`

Fired when a user or group is removed from a group in PingOne.

Groups

Population Created`pingone_webhook_population_created`

Fired when a population is created in PingOne.

Populations

Population Updated`pingone_webhook_population_updated`

Fired when a population is updated in PingOne.

Populations

Population Deleted`pingone_webhook_population_deleted`

Fired when a population is deleted in PingOne.

Populations

Application Created`pingone_webhook_application_created`

Fired when an application is created in PingOne.

Applications

Application Updated`pingone_webhook_application_updated`

Fired when an application's configuration is updated in PingOne.

Applications

Application Deleted`pingone_webhook_application_deleted`

Fired when an application is deleted in PingOne.

Applications

Role Created`pingone_webhook_role_created`

Fired when a custom admin role is created in PingOne.

Roles

Role Updated`pingone_webhook_role_updated`

Fired when a custom admin role is updated in PingOne.

Roles

Role Deleted`pingone_webhook_role_deleted`

Fired when a custom admin role is deleted in PingOne.

Roles

Role Assignment Created`pingone_webhook_role_assignment_created`

Fired when an admin role is assigned to a user, group or application in PingOne.

Role Assignments

Role Assignment Deleted`pingone_webhook_role_assignment_deleted`

Fired when an admin role assignment is removed in PingOne.

Role Assignments

Policy Created`pingone_webhook_policy_created`

Fired when a password policy or sign-on policy is created in PingOne.

Password Policies

Policy Updated`pingone_webhook_policy_updated`

Fired when a password policy or sign-on policy is updated in PingOne.

Password Policies

Policy Deleted`pingone_webhook_policy_deleted`

Fired when a password policy or sign-on policy is deleted in PingOne.

Password Policies

Identity Provider Created`pingone_webhook_identity_provider_created`

Fired when an external identity provider is created in PingOne.

Identity Providers

Identity Provider Updated`pingone_webhook_identity_provider_updated`

Fired when an external identity provider is updated in PingOne.

Identity Providers

Identity Provider Deleted`pingone_webhook_identity_provider_deleted`

Fired when an external identity provider is deleted in PingOne.

Identity Providers

Sign On Policy Assignment Created`pingone_webhook_sign_on_policy_assignment_created`

Fired when a sign-on policy is assigned to an application in PingOne.

Sign-On Policies

Sign On Policy Assignment Deleted`pingone_webhook_sign_on_policy_assignment_deleted`

Fired when a sign-on policy assignment is removed from an application in PingOne.

Sign-On Policies

Device Authentication Policy Created`pingone_webhook_device_authentication_policy_created`

Fired when an MFA device authentication policy is created in PingOne.

MFA

Device Authentication Policy Updated`pingone_webhook_device_authentication_policy_updated`

Fired when an MFA device authentication policy is updated in PingOne.

MFA

Device Authentication Policy Deleted`pingone_webhook_device_authentication_policy_deleted`

Fired when an MFA device authentication policy is deleted in PingOne.

MFA

MFA Device Created`pingone_webhook_device_created`

Fired when an MFA device is added to a user in PingOne.

MFA Devices

MFA Device Updated`pingone_webhook_device_updated`

Fired when a user's MFA device is updated in PingOne.

MFA Devices

MFA Device Nickname Updated`pingone_webhook_device_nickname_updated`

Fired when a user's MFA device nickname is changed in PingOne.

MFA Devices

MFA Device Deleted`pingone_webhook_device_deleted`

Fired when an MFA device is removed from a user in PingOne.

MFA Devices

Certificate Created`pingone_webhook_certificate_created`

Fired when a certificate is created or imported in PingOne.

Certificates

Certificate Updated`pingone_webhook_certificate_updated`

Fired when a certificate is updated in PingOne.

Certificates

Certificate Deleted`pingone_webhook_certificate_deleted`

Fired when a certificate is deleted in PingOne.

Certificates


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.