---
schema_version: "1"
id: 71f56c5d15ad7e4eda1277036222eb7043b4a9bce2d09ca8ce0608f7106a2509
title: AutomatedContactsSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_automatedcontactssettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_automatedcontactssettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: c9879b70d778be09a953a3cf9dc911375f603f3e4ee43deb9105d39c528ae00b
description: Represents an org’s Einstein Automated Contacts settings. These settings let you find new contacts and opportunity contact roles. This type extends the Metadata metadata type and inherits its fullName field.
---
# AutomatedContactsSettings

Represents an org’s Einstein Automated Contacts settings. These settings let you find new contacts and opportunity contact roles. This type extends the Metadata metadata type and inherits its fullName field.

In the package manifest, all organization settings metadata types are accessed using the Settings name. See [Settings](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_settings.htm "Represents the organization settings related to a feature. For example, your password policies, session settings and network access controls are all available in the SecuritySettings component type.") for details.

## File Suffix and Directory Location

AutomatedContactsSettings values are stored in the AutomatedContacts.settings file in the settings folder. The .settings files are different from other named components because there’s only one settings file for each settings component.

## Version

AutomatedContactsSettings is available in API versions 48.0 and later.

## Fields

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



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

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

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

            </tr>

          </thead>

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

              <td class="entry" headers="d165736e105" data-title="Field Type">boolean</td>

              <td class="entry" headers="d165736e108" data-title="Description">Indicates whether new contacts are automatically added from external email accounts
                (such as Microsoft and Google) to Salesforce (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default value is
                <samp class="codeph nolang">false</samp>.
                <p class="p"><span class="keyword parmname">enableAddContactWithSuggestion</span> must
                  be <samp class="codeph nolang">true</samp> to use this
                  setting.</p>
                <div class="p">
                  <div class="box message info">
                    <div class="inner">
                      <div class="bd">
                        <div class="media">
                          <img class="img mtm" src="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note.png" alt="Note">
                          <div class="mediaBd">
                            <h4 class="mbs">Note</h4>
                            <p> When this feature is enabled, users do not see new
                              contacts as suggestions. The contacts are added
                              automatically.</p>
                          </div>
                        </div>
                      </div>
                    </div>
                  </div>

                </div>
              </td>

            </tr>

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

              <td class="entry" headers="d165736e105" data-title="Field Type">boolean</td>

              <td class="entry" headers="d165736e108" data-title="Description">Indicates whether opportunity contact roles from external accounts are automatically
                added to Salesforce (<samp class="codeph nolang">true</samp>) or
                not (<samp class="codeph nolang">false</samp>). The default value
                is <samp class="codeph nolang">false</samp>. <div class="box message info">
                  <div class="inner">
                    <div class="bd">
                      <div class="media">
                        <img class="img mtm" src="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note.png" alt="Note">
                        <div class="mediaBd">
                          <h4 class="mbs">Note</h4>
                          <p> When this
                            feature is enabled, users do not see new contact roles as
                            suggestions. The contact roles are added
                            automatically.</p>
                        </div>
                      </div>
                    </div>
                  </div>
                </div>
              </td>

            </tr>

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

              <td class="entry" headers="d165736e105" data-title="Field Type">boolean</td>

              <td class="entry" headers="d165736e108" data-title="Description">Indicates whether opportunity contact roles from external accounts are suggested as
                new Salesforce opportunity contact roles (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default value is
                <samp class="codeph nolang">true</samp>.
              </td>

            </tr>

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

              <td class="entry" headers="d165736e105" data-title="Field Type">boolean</td>

              <td class="entry" headers="d165736e108" data-title="Description">Indicates whether new contacts from external accounts (such as Microsoft and Google)
                are suggested as new Salesforce contacts (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default value is
                <samp class="codeph nolang">true</samp>.
                <p class="p"><span class="keyword parmname">enableAddContactRoleWithSuggestion</span>
                  must be <samp class="codeph nolang">true</samp> to use this
                  setting.</p>
              </td>

            </tr>


          </tbody>

        </table>

## Declarative Metadata Sample Definition

The following is an example of the AutomatedContactsSettings.settings file:

<?xml version="1.0" encoding="UTF-8"?>
<AutomatedContactsSettings xmlns="http://soap.sforce.com/2006/04/metadata">
	<enableAddContactAutomatically\>true</enableAddContactAutomatically\>
	<enableAddContactRoleAutomatically\>true</enableAddContactRoleAutomatically\>
	<enableAddContactRoleWithSuggestion\>true</enableAddContactRoleWithSuggestion\>
	<enableAddContactWithSuggestion\>true</enableAddContactWithSuggestion\>

</AutomatedContactsSettings\>

## Example Package Manifest

The following is an example package manifest used to deploy or retrieve the AutomatedContacts settings metadata:

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
	<types\>
		<members\>AutomatedContactsSettings</members\>
		<name\>Settings</name\>
	</types\>
	<version\>29.0</version\>
</Package\>

## Wildcard Support in the Manifest File

The wildcard character \* (asterisk) in the package.xml manifest file doesn’t apply to metadata types for feature settings. The wildcard applies only when retrieving all settings, not for an individual setting. For details, see [Settings](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/meta_settings.htm). For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).