---
schema_version: "1"
id: 661a5808bd4ed103e8d8be9c9e0a89cab7c68e93d8fd3903864db02e834bfdad
title: ExternalDataConnector
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_externaldataconnector.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_externaldataconnector.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 1064cc45534eb9640e3e280f98190a518e861b9490878900ec022771a56ff429
description: Used to represent the object where the data was sourced.
---
# ExternalDataConnector

Used to represent the object where the data was sourced.

![Important](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note_important.png)

#### Important

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

## File Suffix and Directory Location

ExternalDataConnector components have the suffix externalDataConnector and are stored in the externalDataConnectors folder.

## Version

ExternalDataConnector components are available in API version 50.0 and later.

## Special Access Rules

You need the Salesforce CustomizeApplication permission to access this object.

## Fields

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



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d474506e90">Field Name</th>

              <th class="featureTableHeader  " id="d474506e93">Field Type</th>

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

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d474506e90" data-title="Field Name"><span class="keyword parmname">dataConnectionStatus</span></td>

              <td class="entry" headers="d474506e93" data-title="Field Type">DataConnectionStatus (enumeration of type string)</td>

              <td class="entry" headers="d474506e96" data-title="Description">Indicates whether you’re connected to a data source. Valid values are:<ul class="ul bulletList">
                  <li class="li"><samp class="codeph nolang">Connected</samp></li>

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

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

                </ul>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d474506e90" data-title="Field Name"><span class="keyword parmname">dataConnectorConfiguration</span></td>

              <td class="entry" headers="d474506e93" data-title="Field Type">string</td>

              <td class="entry" headers="d474506e96" data-title="Description">Reference to the Data Connector Configuration that is used to retrieve or
                receive data such as DataConnectorS3.</td>

            </tr>

            <tr>
              <td class="entry" headers="d474506e90" data-title="Field Name"><span class="keyword parmname">dataConnectorType</span></td>

              <td class="entry" headers="d474506e93" data-title="Field Type">DataConnectorType (enumeration of type string)</td>

              <td class="entry" headers="d474506e96" data-title="Description">Type of connection such as AmazonS3. Valid values are:<ul class="ul bulletList">
                  <li class="li"><samp class="codeph nolang">ACCOUNTENGAGEMENT</samp></li>

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

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

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

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

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

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

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

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

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

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

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

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

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

                </ul>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d474506e90" data-title="Field Name"><span class="keyword parmname">dataPlatform</span></td>

              <td class="entry" headers="d474506e93" data-title="Field Type">string</td>

              <td class="entry" headers="d474506e96" data-title="Description">Reference to the Data Platform that provides or uses this data, such as
                Amazon_S3.</td>

            </tr>


            <tr>
              <td class="entry" headers="d474506e90" data-title="Field Name"><span class="keyword parmname">externalDataTranObjects</span></td>

              <td class="entry" headers="d474506e93" data-title="Field Type"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/meta_externaldatatranobject.htm" target="_blank"><u class="ph u">ExternalDataTranObject</u></a></td>

              <td class="entry" headers="d474506e96" data-title="Description">Stores the schema objects related to the data connector. Available in API
                version 56.0 and later.</td>

            </tr>


            <tr>
              <td class="entry" headers="d474506e90" data-title="Field Name"><span class="keyword parmname">masterLabel</span></td>

              <td class="entry" headers="d474506e93" data-title="Field Type">string</td>

              <td class="entry" headers="d474506e96" data-title="Description">Required. The UI name for the ExternalDataConnector.</td>

            </tr>

          </tbody>

        </table>

## Declarative Metadata Sample Definition

The following is an example of a ExternalDataConnector component.

        <?xml version="1.0" encoding="UTF-8"?>
        <ExternalDataConnector xmlns="http://soap.sforce.com/2006/04/metadata">
        <dataConnectionStatus\>Connected</dataConnectionStatus\>
        <dataConnectorConfiguration\>Person</dataConnectorConfiguration\>
        <dataConnectorType\>AmazonS3</dataConnectorType\>
        <dataPlatform\>Amazon\_S3</dataPlatform\>
        <masterLabel\>AmazonS3</masterLabel\>
        </ExternalDataConnector\>