Skip to content
Last updated: 2026-04-06

Troubleshooting Guide

Find solutions organized by problem type. Select the category that matches your issue for targeted troubleshooting steps.

Troubleshooting by Category

  • Platform Setup & Configuration


    Account setup, data controller configuration, team management, and initial platform deployment.

    • Data Controller Setup Issues - Organization profile and legal configuration
    • Domain Verification Problems - SSL certificate and DNS configuration
    • Team Access Management - User roles, permissions, and invitations
    • Environment Configuration - Development, staging, and production setup

    Platform Setup Diagnostics

  • API & GraphQL Integration


    Authentication, GraphQL queries, webhook delivery, and third-party service connectivity.

    • Authentication Failures - JWT tokens, API keys, and PAT flow issues
    • GraphQL Query Errors - Schema validation, permission errors, and syntax issues
    • Webhook Delivery Problems - Signature validation, connectivity, and payload issues
    • Rate Limiting & Throttling - API quota management and optimization

    API Integration Support

  • Third-Party Service Integration


    Shopify, Stripe, Mailchimp, WooCommerce, and other platform connectors.

    • E-commerce Platform Issues - Shopify, WooCommerce webhook and API synchronization
    • Payment Processor Integration - Stripe transaction monitoring and compliance
    • Marketing Platform Connectivity - Mailchimp, Klaviyo subscriber and preference sync
    • Custom Integration Development - API wrapper and middleware implementation

    Integration Problem Resolution

  • Performance Optimization


    Dashboard loading, API response times, database queries, and report generation.

    • Dashboard Loading - Browser caching, network connectivity, browser compatibility
    • API Response Times - Query optimization and pagination
    • Report Generation - Date range optimization and large dataset handling
    • Widget Performance - Consent widget loading and website integration

    Performance Troubleshooting

  • Security & Compliance


    Compliance configuration, data breach response, and regulatory reporting.

    • GDPR/CCPA Compliance Issues - Regulatory configuration and reporting
    • Consent Collection - Consent widget issues and preference synchronization
    • Rights Request Processing - Access, deletion, and portability request handling

    Security Incident Response

  • Error Code Resolution


    Error code reference with solutions and step-by-step resolution guidance.

    • Platform Error Codes - Dxtra error code reference with solutions
    • Integration Error Messages - Third-party service error interpretation
    • Authentication Errors - Login, token, and permission error resolution

    Error Code Reference

Common Questions

How do I reset my password?
  1. Go to the Dxtra Login Page
  2. Click "Forgot Password"
  3. Enter your registered email address
  4. Check your email for reset instructions
  5. Create a new secure password

Password Requirements

  • Minimum 8 characters
  • Include uppercase and lowercase letters
  • Include numbers and special characters
Why can't I access my Dxtra Dashboard?

Common Causes & Solutions:

Issue Solution
Expired Session Log out completely and log back in
Browser Cache Clear cookies and cache for *.dxtra.ai
VPN/Firewall Check corporate firewall allows *.dxtra.ai
Account Suspended Contact support for account status
How do I change my account email address?
  1. Go to Account Settings in your dashboard
  2. Click "Change Email Address"
  3. Enter your new email address
  4. Verify the new email via confirmation link

Important

The old email address will lose access immediately after verification.

Why are my API calls returning 401 Unauthorized?

Checklist:

  • Valid API Key: Ensure your API key hasn't expired
  • JWT Token: Exchange API key for JWT token first
  • Correct Headers: Include Authorization: Bearer <JWT> and X-Hasura-Role: user
  • Token Expiry: JWT tokens expire after 1 hour - refresh as needed
Test Authentication
curl -X POST https://auth.dxtra.ai/v1/signin/pat \
  -H "Content-Type: application/json" \
  -d '{"personalAccessToken": "YOUR_API_KEY"}'

View Authentication Guide

My webhooks aren't being received. What's wrong?

Webhook Debugging Steps:

  1. Check Webhook URL: Ensure it includes correct did and dxKey parameters
  2. Verify HTTPS: Webhook endpoints must use HTTPS
  3. Test Connectivity: Use webhook testing tools to verify reachability
  4. Review Logs: Check your server logs for incoming requests
  5. Signature Validation: Ensure webhook signatures are being validated correctly

Webhook URL Format:

Text Only
https://conduit.dxtra.ai/integrations/{service}/event?did=YOUR_DID&dxKey=YOUR_KEY

How do I troubleshoot GraphQL errors?

Typical GraphQL Error Response:

JSON
{
  "errors": [
    {
      "message": "Field 'names' is not defined by type 'DataController'",
      "locations": [{"line": 4, "column": 7}],
      "path": ["dataControllers"]
    }
  ]
}

Resolution Steps: 1. Check Field Names: Verify against GraphQL schema 2. Validate Permissions: Ensure role has required access 3. Review Query Structure: Check syntax and nesting 4. Consult API Docs: Reference field definitions

GraphQL API Reference

How do I configure my first Data Controller?
  1. Log into Dxtra Dashboard
  2. Create Data Controller
  3. Navigate to Settings > Data Controllers
  4. Click "Add Data Controller"
  5. Fill in organization details
  6. Configure Domain
  7. Add your website domains
  8. Verify domain ownership
  9. Invite Team Members
  10. Set up user roles and permissions
  11. Send invitation emails
  12. Complete Onboarding
  13. Review compliance settings
  14. Configure consent preferences

Detailed Setup Guide

What integrations are available?

Currently Supported:

Platform Type Status
Shopify E-commerce Active
Stripe Payments Active
Mailchimp Marketing Active
WooCommerce E-commerce Active
Klaviyo Marketing Active
Customer.io Marketing Active
Eventbrite Events Partial
SurveyMonkey Surveys Partial
QuickBooks Accounting Partial

Browse All Integrations

How does Dxtra help with GDPR compliance?

GDPR Compliance Features:

  • Lawful Basis Tracking: Legal basis assignment and documentation
  • Data Subject Rights: Processing of access, deletion, and portability requests
  • Audit Trails: Processing activity records for Article 30 compliance
  • Data Minimization: Collect and process only necessary data
  • Breach Notification: DPA notification workflows

Complete GDPR Guide

What about CCPA compliance?

CCPA Compliance Features:

  • Right to Opt-Out: "Do Not Sell" implementation
  • Right to Know: Data disclosure processes
  • Right to Delete: Consumer data deletion workflows
  • Non-Discrimination: Equal service regardless of privacy choices

Response Timeline Requirements: - Access Requests: 45 days maximum - Deletion Requests: 45 days maximum - Opt-Out Requests: 15 days maximum

CCPA Compliance Guide

Getting Help

Self-Service Resources

  • Search Documentation: Use Ctrl+K to search across all documentation
  • Error Code Reference: Check Error Messages for specific errors
  • Integration Guides: Review service-specific guides for integration issues

Contact Support

If you cannot resolve an issue using self-service resources:

  1. Gather relevant information:
  2. Error messages (exact text)
  3. Screenshots of the issue
  4. Steps to reproduce
  5. Browser and OS information

  6. Contact support via email: support@dxtra.ai

Contact Support