---
schema_version: "1"
id: bd009345e6c5aa54469d852f26b339ba32fc05e413460aa1a00da7f7d9437efe
title: Data Connectors List Resource
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_resources_dataconnectors.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_dataconnectors.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 1fe23b321591824e597260a99665d561ff48acd84b06e9cf6f992e35f66c1f23
description: Returns a collection of Analytics connectors and creates an Analytics connector.
---
# Data Connectors List Resource

Returns a collection of Analytics connectors and creates an Analytics connector.

## Resource URL

/wave/dataConnectors

## Formats

JSON

## Available Version

39.0

## Available in Postman

To view and test a working example of this resource, see [getDataConnectorCollection](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/request/12721794-5a36e087-493b-43b2-9387-ee5b5c8fd589?action=share&source=copy-link&creator=26106753 "HTML (New Window)") in Postman. For information about how to authenticate your org with Postman, see the [CRM Analytics Rest API Quick Start](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/crma_rest_api_quick_start.htm "Connect to a Salesforce Trailhead org and authenticate. Then make a request to the CRM Analytics REST API in Postman, and look at the response.").

## Available Components

- LWC — [lightning/analyticsWaveApi getDataConnectors()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-wire-adapters-get-data-connectors.html)
- LWC — [lightning/analyticsWaveApi createDataConnector()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-analytics-create-data-connector.html)

## HTTP Methods

GET POST

## Request parameters for GET

<table class="featureTable sort_table" summary="">





          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d268880e140">Parameter Name</th>

              <th class="featureTableHeader vertical-align-top " id="d268880e143">Type</th>

              <th class="featureTableHeader  " id="d268880e146">Description</th>

              <th class="featureTableHeader  " id="d268880e149">Required or Optional</th>

              <th class="featureTableHeader vertical-align-top " id="d268880e152">Available Version</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d268880e140" data-title="Parameter Name"><samp class="codeph nolang">category</samp></td>

              <td class="entry" headers="d268880e143" data-title="Type">Connect​Wave​Connector​Category​Enum</td>

              <td class="entry" headers="d268880e146" data-title="Description">The categories that the data connector belongs to. Valid values are:
                <ul class="ul bulletList">
                  <li class="li"><samp class="codeph nolang">Advanced​Properties​Support</samp></li>

                  <li class="li"><samp class="codeph nolang">Batch​Read</samp></li>

                  <li class="li"><samp class="codeph nolang">Direct</samp></li>

                  <li class="li"><samp class="codeph nolang">File​Based</samp></li>

                  <li class="li"><samp class="codeph nolang">Filter​Support</samp></li>

                  <li class="li"><samp class="codeph nolang">Output</samp></li>

                  <li class="li"><samp class="codeph nolang">Private</samp></li>

                </ul>

              </td>

              <td class="entry" headers="d268880e149" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d268880e152" data-title="Available Version">49.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d268880e140" data-title="Parameter Name"><samp class="codeph nolang">connector​Type</samp></td>

              <td class="entry" headers="d268880e143" data-title="Type">Connect​Wave​Data​Connector​Type​Enum</td>

              <td class="entry" headers="d268880e146" data-title="Description">For a full list of the data connector types, see the
                <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_dev_guide_rest_enums.htm#ConnectWaveDataConnectorTypeEnum_desc">enum description</a>.
              </td>

              <td class="entry" headers="d268880e149" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d268880e152" data-title="Available Version">39.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d268880e140" data-title="Parameter Name"><samp class="codeph nolang">folder​Id</samp></td>

              <td class="entry" headers="d268880e143" data-title="Type">Id</td>

              <td class="entry" headers="d268880e146" data-title="Description">Filters the results to include on the contents of a specific folder. The id can
                be the requesting user's ID for items in the user's private folder.</td>

              <td class="entry" headers="d268880e149" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d268880e152" data-title="Available Version">49.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d268880e140" data-title="Parameter Name"><samp class="codeph nolang">scope</samp></td>

              <td class="entry" headers="d268880e143" data-title="Type">Connect​Wave​Scope​Type​Enum</td>

              <td class="entry" headers="d268880e146" data-title="Description">The type of scope to be applied to the returned collection. Valid values are: <ul class="ul bulletList">
                  <li class="li"><samp class="codeph nolang">Browse</samp></li>

                  <li class="li"><samp class="codeph nolang">Created​By​Me</samp></li>



                  <li class="li"><samp class="codeph nolang">Insights​Applications​Is​Cans​Edit</samp></li>

                  <li class="li">
                    <samp class="codeph nolang">Mru</samp> (Most Recently Used)
                  </li>

                  <li class="li"><samp class="codeph nolang">Shared​With​Me</samp></li>

                </ul>
              </td>

              <td class="entry" headers="d268880e149" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d268880e152" data-title="Available Version">38.0</td>

            </tr>

          </tbody>

        </table>

## Response body for GET

[Data Connector Collection](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_data_connector_collection.htm "A collection of Analytics data connectors.")

## Request body for POST

[Data Connector Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_data_connector_input.htm "An Analytics data connector.")

The following JSON shows how to create a new Analytics connector, of connectorType SalesforceExternal.

{
  "label": "My SalesforceExternal Connector",
  "name" : "mySFDCExt",
  "description" : "Connection to another Salesforce org.",
  "connectorType" : "SalesforceExternal",
  "connectorHandler" : "Legacy",
  "connectionProperties" : \[ {
      "name" : "Password",
      "value" : "\*\*\*\*\*\*\*"
    }, {
      "name" : "Service\_URL",
      "value" : "https://MyDomainName.my.salesforce.com
/services/Soap/u/53.0"
    }, {
      "name" : "Username",
      "value" : "user@yourSalesforceOrg.org"
    }, {
      "name" : "APIType",
      "value" : "BULKV2"
    }
  \]
}

## Response body for POST

[Data Connector](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_data_connector.htm "An Analytics data connector.")