For the complete documentation index, see llms.txt. This page is also available as Markdown.

Common Issues

Connection issues

"Signin Error" or "401001: Error signing in to Tableau Server"

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

"Invalid View URL" error

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

"Bad Request" or "400081" error

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.

"Service Unavailable" or "503" error

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

"429 Too Many Requests" or rate limit error

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

Missing data

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

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.:

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:

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-")

  • 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

Data format or dates look wrong in the destination

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

Permission errors

"Not authorized" or permission denied when running the flow

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

"No authorization to query data for view" error

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

Data discrepancies

Data in Coupler.io export differs from Tableau visualization

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

Columns are returned as rows, under columns "Measure Names" and "Measure Values"

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:

Last updated

Was this helpful?