Skip to main content

Integrating Descope

Capabilities​

DataGrail's Descope integration provides the following capabilities:

ProductCapability
Request Manager
Request TypesAccess, Deletion
Identifier CategoriesEmail, Phone

Before You Start​

To successfully configure this integration, please ensure you have sufficient privileges:

  • DataGrail User Role: Super Admin, Connections Manager
  • Descope User Role: Admin

Get API Credentials​

  1. Log in to your Descope account.
  2. In the left menu, select Settings and then Project.
  3. Copy the Project ID.
  4. In the left menu, select Settings and then Company.
  5. Select Management Keys.
  6. Select the Management Key button.
  7. Configure the new management key:
Management Key Configuration
  • Name: DataGrail
  • Expiration: Never
  • Use this management key for the following projects: Your Project
  1. Copy the Management Key.

Connect to DataGrail​

  1. Navigate back to DataGrail.
  2. Enter the Project ID and Management Key created during Get API Credentials.
  3. Select Configure Integration.

Next Steps​

Now that you've successfully connected the integration, check out the following resources:

Troubleshooting​

If you are unable to successfully connect the integration, review these common troubleshooting steps:

Ensure Required Permissions Are Granted on API Keys/Resources

DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.

Review Required Account Types and User Roles

If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.

See Before You Start to review these requirements.

Technical Details​

The Descope integration uses the Descope User Management API:
Access TypeSynchronous
Deletion TypeSynchronous

API Documentation​

Learn more about this API implementation and DataGrail functionality in our API Integration Documentation.

 

Need help?
If you have any questions, please reach out to your dedicated CSM or contact us at support@datagrail.io.

Disclaimer: The information contained in this message does not constitute as legal advice. We would advise seeking professional counsel before acting on or interpreting any material.