Integrating Khoros

Capabilities

DataGrail's Khoros integration provides the following capabilities:

Product	Capability
Request Manager	Request Types Access, Deletion Identifier Categories Email

Before You Start

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

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

Configure Khoros API Access

1. Log in to your Khoros Community account.
2. Get your Community Domain from the browser URL, for example community-stage.acme.com or community.khoros.com
3. Navigate to Community Admin.
4. Navigate to System, then API Apps, and select Create Web App.
5. Configure application in the Create API App modal with the following values, and select Save:

App Configuration

Display Name: DataGrail

Authorization Redirect URL: https://datagrail.io/oauth/khoros

6. Copy your Client ID and Client Secret from the API Apps tab and store them in a temporary, secure location.
7. Navigate to Users, then Permissions, then Defaults.
8. Under the REST API section, select Allow Grant for the following permissions:

Required User Permissions

• Make REST API V1 calls with read access
• Make REST API V1 calls with modify access

9. Navigate to Users, then Permissions and find your user using Select User.

10. Validate that the user is assigned at least the Administrator role.

11. Scroll down, and check that your user has the following permissions marked as Allow Grant:

    Required Permissions

    REST API

    • Make REST API V1 calls with read access.
    • Make REST API V1 calls with modify access.

    API Apps

    • Manage API Apps.

    User Management

    • Close accounts of other users.

Important

Users may be required to have their IP address added to an allowlist in order to connect to Khoros.

Connect to DataGrail

1. Navigate back to DataGrail.
2. Enter the Client ID, Client Secret, and Community Domain.
3. Select Login to Configure.

Next Steps

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

• Access Request Lifecycle
• Deletion Request Lifecycle
• Request Manager Overview
• Customizing Intake Forms

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

Access Type	Synchronous
Deletion Type	Synchronous

API Documentation

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