Integration Errors

Integration Errors helps you quickly identify and resolve issues with your connected integrations. Instead of investigating individual failed requests one at a time, you can now see all integration errors in one centralized dashboard, making it easier to spot patterns and prioritize fixes.

The dashboard shows errors from the last 30 days, grouped by integration and error type, so you can quickly understand which connections need attention.

Integration Errors Block Privacy Operations

An unresolved integration error will block your Privacy Requests and other operations. By monitoring and resolving integration errors proactively, you ensure privacy requests complete successfully and on time.

Viewing Integration Errors

Super Admin, Request Agent, Live Data Map Admin, and Connections Manager roles can view the Integration Errors page.

1. Select Integrations in the main navigation
2. Navigate to the the Errors tab
3. View your error dashboard with filtering and search

Review Integration Status for more information on different response codes and what you can do to resolve them.

Understanding The Error Dashboard

The error dashboard displays a table with the following information. Use the filters and search bar to isolate errors for specific connections or error types.

Column	Description
Integration	The name of the integration with the error.
Error Type	The category of error (e.g., API Unauthorized, API Rate Limit). See Integration Status for what each error means and how to fix it.
Count	How many times this error occurred in the last 30 days. High counts indicate recurring issues that should be addressed promptly.
First Seen	When this error first appeared within the 30-day window.
Last Seen	The most recent occurrence of this error.

Investigating Error Details

Select any row in the table to open a detailed panel with the Error Summary and up to 3 Sample Logs.

The panel displays an Error Summary with the integration name (linked to full settings), error type and description, total count, and first/last occurrence dates.

Below that you'll see up to 3 Sample Logs with timestamps, status codes, error messages, links to affected Data Subject Requests (if available), and the complete JSON response from the API.

Use the error details to diagnose and resolve issues:

1. Check the error message and status code to identify the problem, and review Integration Status for more information on each status code.
2. Review multiple sample logs to identify patterns.
3. Select Data Subject Requests to see impacted privacy requests.
4. Copy the JSON response to share with support or the vendor, if needed.

Best Practices

Follow these best practices to maintain healthy integrations and minimize disruptions to your privacy request workflow.

Regular Monitoring

• Check the Integration Errors Dashboard weekly
• Pay attention to Last Seen dates to identify active issues
• Address errors with high counts first

Proactive Maintenance

• Refresh credentials before they expire
• Monitor rate limit errors and request limit increases with vendors, if needed
• Keep integration configurations up to date when vendors make changes

When to Escalate to DataGrail

• Errors persist for more than 48 hours after attempting fixes
• You've refreshed credentials, but still see authorization errors
• Multiple integrations show the same error type simultaneously