Integrating TeamUp | DataGrail Documentation
Capabilities
DataGrail's TeamUp integration provides the following capabilities:
| Product | Capability |
|---|---|
| Request Manager | Request Types |
| Identifier Categories |
Before You Start
To successfully configure this integration, please ensure you have sufficient privileges:
- DataGrail User Role: Super Admin, Connections Manager
- TeamUp User Role: Admin
Get API Credentials
- Log in to TeamUp.
- In the left menu, select Settings and then Integrations.
- In the dropdown list of API Integration options, select Manage Applications.
- Select Create API Integration.
- Enter the following information for the new application:
Application Configuration
- Type of Application:
Business - Domain URL:
https://datagrail.io/ - OAuth Return URL:
https://datagrail.io/oauth/teamup - Scope:
Read/Write
- Select Create.
- Copy the Client ID and Client Secret. Store them in a secure, temporary location.
Connect to DataGrail
- In DataGrail, navigate to Integrations and select Configure New Integration to search for TeamUp.
- Enter the Client ID and Client Secret created during Get API Credentials.
- Select your desired Asynchronous Deletion Behavior.
TeamUp Deletion Behavior Configuration
Mark integration as complete when a deletion request is successfully submitted:
The TeamUp Integration will be marked as "complete" as soon as the deletion request is submitted to TeamUp.
Continue processing until the deletion request is completed (default behavior):
The TeamUp Integration will show a "processing" status until the TeamUp deletion is complete.
- Select Login to Configure.
- Log in to TeamUp if prompted.
- Select your profile and authorize read permissions to DataGrail.
Next Steps
Now that you've successfully connected the integration, check out the following resources:
- Synchronous vs. Asynchronous Integrations
- Whole Record Deletion
- Access Request Lifecycle
- Deletion Request Lifecycle
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 TeamUp integration uses the TeamUp Business API:
| Access Type | Synchronous |
|---|---|
| Deletion Type | Asynchronous (Whole Record) |
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 Account Manager 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.