---
title: "Common Error Solutions"
canonical_url: "https://docs.getdx.com/common-errors/"
md_url: "https://docs.getdx.com/common-errors.md"
last_updated: "2026-05-19"
---

# Common Error Solutions
This page provides solutions for the most common errors you may encounter when setting up data connectors in DX.

## Error Codes

### 401 - Unauthorized

**Description:** Your connection credentials are invalid or have expired.

**Common Causes:**

- Expired or revoked API token
- Incorrect username/email
- Invalid API key
- Token permissions insufficient
- A firewall is blocking the request

**Solutions:**

- Verify your credentials are correct
- Check if your API token has expired
- Ensure the token has the required permissions
- Regenerate a new API token if necessary
- Ensure your firewall allows requests with auth headers intact
- Ensure DX's IP address is whitelisted if needed

---

### 403 - Forbidden

**Description:** Your credentials are valid but you don't have permission to access the requested resources.

**Common Causes:**

- Insufficient permissions on the credentials
- Project/workspace access restrictions
- A firewall is blocking the request

**Solutions:**

- Verify the service account has the necessary permissions
- Check if additional scopes are required
- Ensure DX's IP address is whitelisted if needed

---

### 404 - Not Found

**Description:** The connection URL or resource path is incorrect.

**Common Causes:**

- Incorrect base URL

**Solutions:**

- Verify the base URL is correct

---

### Connection Timeout

**Description:** The connection to your service is timing out.

**Common Causes:**

- Firewall blocking the connection
- Network restrictions or proxy settings
- Service temporarily unavailable
- Incorrect base URL format

**Solutions:**

- Check if your firewall allows outbound connections to our servers
- Verify your network/proxy settings
- Ensure the base URL is correct and accessible
- Contact your network administrator if needed

---

## Getting Help

1. Contact [DX Support](mailto:support@getdx.com)
---

## Sitemap

[Overview of all docs pages](/llms.txt)