# Common Issues

## Connection issues

<details>

<summary>"Signin Error" or "401001: Error signing in to Tableau Server"</summary>

This means Coupler.io couldn't authenticate with your Tableau instance.

**Fix:**

* Verify your **View URL** is complete and correct (starts with `https://` and includes the full path like `#/site/SiteName/views/Workbook/View`)
* Confirm you have **Viewer** permissions (or higher) on the Tableau view
* If you're using Tableau Cloud, ensure your account is active and not expired
* For **Tableau Server** behind a firewall, you may need to allowlist Coupler.io's IP addresses — contact support
* Try signing in to Tableau directly in your browser to confirm your credentials are working

</details>

<details>

<summary>"Invalid View URL" error</summary>

The URL you entered doesn't match Tableau's expected format.

**Fix:**

* Copy the URL directly from your browser's address bar while viewing the Tableau view (don't copy from an email or shared link)
* Make sure the URL contains `#/site/` or `#/views/` — this indicates a direct view link
* Remove any query parameters (like `?:embed=yes` or `&:refresh=yes`) from the end
* Example of a valid URL: `https://MY-SERVER/#/site/SiteName/views/Workbook/View`

</details>

<details>

<summary>"Bad Request" or "400081" error</summary>

Tableau rejected the data export request, often due to view structure or API limitations.

**Possible causes and fixes:**

* The view contains **multiple sheets** and the first sheet (alphabetically) doesn't have exportable data. Rename sheets so the one you want comes first alphabetically, or contact support to discuss alternatives.
* The view uses **advanced parameters or custom filters** that the API doesn't support. Try exporting a simpler version of the view.
* Your Tableau instance has **API quotas or rate limits** enabled. Wait a few minutes and retry.
* The view contains **images, custom visualizations, or non-tabular content** that can't be exported as data. Ensure your view has a standard table or data source.

</details>

<details>

<summary>"Service Unavailable" or "503" error</summary>

Tableau Server is temporarily unreachable or overloaded.

**Fix:**

* Wait 5–10 minutes and try running the data flow again
* Check Tableau's status page or contact your Tableau admin to confirm the server is online
* If this persists, the server may have scheduled maintenance — retry during off-peak hours

</details>

<details>

<summary>"429 Too Many Requests" or rate limit error</summary>

Tableau or Coupler.io has temporarily throttled requests.

**Fix:**

* **Wait 5–10 minutes** before retrying — rate limits typically reset automatically
* **Space out your data flow runs** — don't schedule overlapping flows or run multiple simultaneously
* If you're exporting large, complex views, consider **breaking them into smaller views** in Tableau to reduce API load
* For production schedules, use **off-peak hours** (early morning, late evening) to avoid rate limits

</details>

## Missing data

<details>

<summary>Only the first tab/sheet/graph is exported on a multi-sheet dashboard</summary>

Due to the specifics of the Tableau API, when pulling data from the Tableau view (dashboard), only *the alphabetically-first worksheet (tab/sheet/graph)* from this view will be pulled.

E.g.:

<figure><img src="https://1055512216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOFxU2LUkJMCfvbE2re5C%2Fuploads%2F3VMEbqxmSFeREnxgNYXY%2Fimage.png?alt=media&#x26;token=071c43d0-1889-48c8-874b-b592ec9b92fc" alt=""><figcaption></figcaption></figure>

The first worksheet we see in the selected view is named "ProductView". While the second one is named "ProductDetails".

Since the alphabetically-first worksheet is the one named "ProductDetails", the data pulled with Coupler.io will match data from the "ProductDetails" worksheet:

<figure><img src="https://1055512216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOFxU2LUkJMCfvbE2re5C%2Fuploads%2FGDQeaBc5palyM5CTdJzt%2Fimage.png?alt=media&#x26;token=56046688-6b63-4722-a49f-5baadbf6d8c8" alt=""><figcaption></figcaption></figure>

**Fix:**

* If you need a different worksheet, rename the sheets in Tableau, so your desired sheet comes first alphabetically (e.g., prefix it with "A-")<br>

  <figure><img src="https://1055512216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOFxU2LUkJMCfvbE2re5C%2Fuploads%2FGTHr9A4km4ZOwS8c7SeX%2Fimage.png?alt=media&#x26;token=4506e12b-3602-4cbd-a910-eb3ae7191d2b" alt=""><figcaption></figcaption></figure>

  <figure><img src="https://1055512216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOFxU2LUkJMCfvbE2re5C%2Fuploads%2FhwQcAvZqGXHz5oN6D5Ea%2Fimage.png?alt=media&#x26;token=4eec4592-51f1-4bb6-b10d-6b03816cb358" alt=""><figcaption></figcaption></figure>
* Alternatively, create a separate Tableau view for each sheet you want to export and set up individual data flows for each
* Contact support if you need a workaround for complex multi-sheet dashboards

</details>

<details>

<summary>Data format or dates look wrong in the destination</summary>

Tableau data exports in Tableau's native format; your destination may interpret dates or numbers differently.

**Fix:**

* In Google Sheets, use the **Format** menu to set the correct date format or number formatting
* In BigQuery, specify the data type during import or use a **transformation step** to cast columns
* Check Tableau's original view to confirm the data is correct before export
* If dates are off by timezone, this is a display issue in your destination — the underlying data from Tableau is correct

</details>

## Permission errors

<details>

<summary>"Not authorized" or permission denied when running the flow</summary>

Tableau requires explicit permissions to the view being exported.

**Fix:**

* Verify the Tableau view is **not private** to you — it should be accessible to at least Viewer level
* Ask your Tableau site admin to grant you (or the Coupler.io integration user) Viewer access
* For **Tableau Server**, confirm the view is published to a shared site, not a personal workspace
* Test access by logging into Tableau directly and opening the view manually

</details>

<details>

<summary>"No authorization to query data for view" error</summary>

Your Coupler.io account or Tableau user lacks permissions on the view.

**Fix:**

* Confirm you have **Viewer** permissions (minimum required) or higher on the Tableau view
* Ask your Tableau admin to grant you access to the view
* If you're using a shared Tableau account for Coupler.io, ensure that account is active and not restricted

</details>

## Data discrepancies

<details>

<summary>Data in Coupler.io export differs from Tableau visualization</summary>

This usually happens when Tableau view has filters, parameters, or aggregations applied.

**Why:**

* Coupler.io exports the **underlying data**, not the visualized/filtered version
* If the Tableau view has filters applied, those are included — but if filters are external URL parameters, they may not be captured
* Some Tableau calculations or custom expressions may not translate to tabular exports

**Fix:**

* Check the Tableau view's filter state — ensure all intended filters are applied *within* the view
* Compare the raw data (right-click > **View Data** in Tableau) with your Coupler.io export
* If discrepancies persist, contact support with your view URL and details about the missing or extra data

</details>

<details>

<summary>Columns are returned as rows, under columns "Measure Names" and "Measure Values"</summary>

Tableau API returns CSV data. Coupler.io just converts it to JSON, and that's how it is displayed in the destination further.

Because of it, you may see columns from Tableau shown as rows in Coupler.io, grouped under columns "Measure Names" and "Measure Values".

As a workaround, you may aggregate data in the needed way in the Destination. E.g.: create a Pivot table in a destination spreadsheet, with 'Measure Names' as Columns and 'Measure Values' as Values:

<figure><img src="https://docs.coupler.io/~gitbook/image?url=https%3A%2F%2F2487187314-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCgnmco7kCnvytNIN8YdT%252Fuploads%252FtUEMNUlz14IstbYqx2Es%252Fimage.png%3Falt%3Dmedia%26token%3Deb96d593-87db-4f0d-a186-29f3c88eae6e&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=ef58272b&#x26;sv=2" alt=""><figcaption></figcaption></figure>

</details>