---
schema_version: "1"
id: 8e26d92838bb1ba622e70f7c2cb34f3578bdfb565579226602528d1bba2f9432
title: Get Started
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/api/webdataconnector/index.md
canonical_url: https://help.tableau.com/current/api/webdataconnector/en-us/index.html
source_site: help.tableau.com
content_type: documentation
content_hash: c4b2c9e04b3b3b7d9e67e8192840e8d98f7be1b6c438cb9c4b5bfb568b7205af
description: Documentation for the Tableau Web Data Connector
---
**Deprecated** - This repository will be removed with the Tableau 26.3 release.

The Web Data Connector 3.0 framework is deprecated and will not receive further updates. Migrate to the [REST API Connector on Tableau Exchange](https://exchange.tableau.com/products/1111)—built by Tableau, supports JSON and CSV over HTTP GET, Basic/Bearer/OAuth authentication, and runs on Tableau 2023.3 and later. Note: this connector is extract-only and requires a JDBC driver installation.

# Get Started

  

🕐 _3 min read_

Create a web data connector when you want to connect to a web data source from Tableau. A web data connector is a packaged connector containing web elements. It connects to web data (for example, by means of a REST API), converts the data to a JSON format, and passes the data to Tableau.

**Note**: The TACO Toolkit, which helps you build your connectors, is only available for Windows and macOS. Linux is not supported.

## Build a sample web data connector

This section guides you through the process of setting up your development environment and building a sample web data connector in the simulator.

To best understand what a web data connector is, we recommend that you build a sample connector using a boilerplate included in the Taco Toolkit. To build a sample connector, perform the following tasks.

1. Make sure you have the following dependencies installed:
    
    - [Node version 16 and npm version 7 and above](https://nodejs.org/en/download/)
    - [Python 3.7 or higher](https://www.python.org/downloads/)
    - [JDK 11 or higher](https://www.oracle.com/java/technologies/downloads/)
    
    **OS Notes**:
    
    - If you're using Windows and installing Node.js, we recommend that you click the option to install the Python and Visual Studio Build Tools.
    - For macOS, you must install XCode Command Line Tools. If you don't already have it installed, you can install XCode Command Line Tools standalone by running \`xcode-select --install\` in Terminal or, alternatively, install the \[full version of XCode\](https://developer.apple.com/xcode/).
2. Install the TACO Toolkit by opening your terminal and typing the following command:
    
    ```
    npm install -g @tableau/taco-toolkit@tableau-<version>
    ```
    
    Where `version` is your version of Tableau. For example:
    
    ```
    npm install -g @tableau/taco-toolkit@tableau-2024.1
    ```
    
    This command installs the toolkit globally. The Taco Toolkit includes:
    
    - Taco CLI
    - Web data connector boilerplate connector
    - Web data connector 3.0 SDK
    - Various utilities for building, packaging, and signing your connectors
3. Verify the install by typing the following:
    
    ```
    taco
    ```
    
    This command returns the CLI version.
4. Create a parent directory for your connectors and navigate to that directory.
5. Enter the following command to create the connector:
    
    ```
    taco create my-first-connector --boilerplate earthquake-data
    ```
    
    This creates a directory with the earthquake data boilerplate code, which is included with the toolkit.
6. Change directories to the myConnector directory.
    
    ```
    cd my-first-connector
    ```
7. Build the connector by entering the following command:
    
    ```
    taco build
    ```
    
    This command clears any previous or existing build caches, then installs the dependencies, then builds the frontend code and the backend code (handlers), then copies the connector.json file (the configuration file).
8. Create the Taco file
    
    ```
    taco pack
    ```
    
    This creates the .taco file
9. Type the following command to run the connector:
    
    ```
    taco run Desktop
    ```
    
    This starts Tableau Desktop with the appropriate command-line parameters pointing it to your newly created connector.
10. Launch the connector in Tableau Desktop. You’ll see a link to your connector in Tableau’s list of connectors, **my-first-connector by vendor-name**. To see your dialog, click the link. ![Tableau Desktop showing the new connector](/tableau/current/en-us/api/webdataconnector/en-us/assets/connector_in_tableau.png)
    
    Tableau loads your default system browser to show the connector user interface (UI). This is the interactive phase.
11. Click the **Get Earthquake Data** button. Clicking this button closes the browser pane. A Tableau worksheet opens with your connected data.

## What’s next?

You can [customize your connector](/current/api/webdataconnector/en-us/docs/wdc_customize_connector.html) with your own information. Or, if you’re ready to make your own connector, you can use one the [connector boilerplates](/current/api/webdataconnector/en-us/docs/wdc_samples.html) to make your own.