Error Messages Reference¶

Error example:

{
  "status": "error",
  "message": "No authorization header provided",
  "data": null
}

Solution: 1. Include the Authorization header in your requests 2. Format: Authorization: Bearer YOUR_JWT_TOKEN 3. Generate a new API key from Dashboard > Settings > API Keys if needed

Error example:

{
  "status": "error",
  "message": "JWT token has expired",
  "data": null
}

Solution: 1. JWT tokens expire after 1 hour for security 2. Exchange your API key for a fresh JWT token:

curl -X POST https://auth.dxtra.ai/v1/signin/pat \
  -H "Content-Type: application/json" \
  -d '{"personalAccessToken": "YOUR_API_KEY"}'

1. Use the new accessToken from the response

Authentication Guide

Error example:

{
  "status": "error",
  "message": "Invalid personal access token",
  "data": null
}

Solution: 1. Verify your API key is correct (no extra spaces/characters) 2. Check if the API key has been revoked or expired 3. Generate a new API key from the Dashboard 4. Ensure you're using the correct Data Controller's API key

Error example:

{
  "status": "error",
  "message": "User does not have required role permissions",
  "data": null
}

Solution: 1. Check your current role in Dashboard > Settings > Team 2. Required permissions by action: - View data: Viewer role or higher - Modify settings: Editor role or higher - Manage integrations: Administrator role or higher - Manage team: Administrator role or higher 3. Ask an Administrator to upgrade your role if needed

Error example:

{
  "status": "error",
  "message": "Access denied to data controller resources",
  "data": null
}

Solution: 1. Verify you're using the correct API key for the intended Data Controller 2. Check if you have access to the specific Data Controller in the Dashboard 3. Ensure the X-Hasura-Role header is set correctly (usually user)

Error: Failed to connect to Shopify store

Shopify Integration Guide

Error: Failed to authenticate with Mailchimp

Mailchimp Integration Guide

Error: Stripe webhook validation failed

Stripe Integration Guide

Error: Data sync failed

Troubleshooting steps:

1. Check Integration Status:
2. Go to Dashboard > Integrations
3. Look for warning icons or error messages

4. Click "View Details" for specific error information

5. Common sync issues:

1. Manual Sync Options:
2. Click "Sync Now" for immediate retry
3. "Reconnect Integration" for authentication issues
4. "View Logs" for detailed error information

Error: Invalid data format detected during sync

Resolution steps:

1. Identify problematic records:
2. Check integration logs for specific record IDs

3. Look for patterns (e.g., missing required fields)

4. Common data issues:

5. Empty or null required fields (name, email)
6. Invalid email format
7. Unsupported characters in data

8. Date format mismatches

9. Fix at the source:

10. Clean data in the third-party service
11. Retry sync after data correction

Error: Dxtra consent widget failed to load

Debugging checklist:

• Script URL: Verify https://transparencycenter.dxtra.ai/embed.js is accessible
• Domain Verification: Ensure your domain is added to Data Controller settings
• HTTPS: Consent widgets require HTTPS websites
• Content Security Policy: Add transparencycenter.dxtra.ai to allowed domains
• Ad Blockers: Test with ad blockers disabled

Testing script:

<script>
  console.log('Loading Dxtra widget...');
  const script = document.createElement('script');
  script.src = 'https://transparencycenter.dxtra.ai/embed.js';
  script.onload = () => console.log('Widget loaded successfully');
  script.onerror = () => console.error('Widget failed to load');
  document.head.appendChild(script);
</script>

Error: Consent preferences not being saved