# Synchronize object attributes

### Overview <a href="#overview" id="overview"></a>

In this destination service, DinMo will update attributes in the object table, and, optionally, insert new objects.

{% hint style="info" %}
Standard Objects correspond to **Account**, **Case**, **Contact**, **Contract** or **Lead** in Salesforce.
{% endhint %}

To do so, you will need to go through these three steps:

* Creating a Salesforce destination. Refer to the[ corresponding section](https://docs.dinmo.io/integrations/destination-platforms/salesforce) for more info.
* Creating a segment or model composed of all the standard objects and their attributes that will be updated in Salesforce.

{% hint style="info" %}

* If you want to update **Contacts** or **Leads**: use a **user model/segment**
* If you want to update **Account**, **Case** or **Contract**: use a **custom model/segment**
  {% endhint %}

- Activating the model or segment to the Salesforce destination to start sending data. Refer to the [corresponding section](https://docs.dinmo.io/integrations/destination-platforms/braze/synchronize-users-attributes#activation-configuration) for more info.

### Destination Setup

To start updating standard objects with, you are first required to create a Salesforce destination with the corresponding destination service.

When configuring the destination, you are asked to select the **standard object** you wish to update:

<figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2FpzBUdQSMBEL0ndjKIYOP%2Fimage.png?alt=media&#x26;token=cee28673-071a-487e-ad14-528be3dbad01" alt=""><figcaption><p>Standard Object selected: Contract</p></figcaption></figure>

That means you need to set up a **separate sync configuration** for each object you want to sync to.

### Activation Configuration

Once the destination has been setup, and your DinMo model created, you can create an activation to start sending data to Salesforce right away.

{% hint style="info" %}
Learn how to activate a segment in our [step-by-step tutorial](https://docs.dinmo.io/guides/get-started-with-dinmo/create-and-activate-segments-on-dinmo/activate-your-first-segment)
{% endhint %}

#### Synchronization mode

The first thing DinMo'll ask you when setting up a sync to Salesforce is what type of data transfer you want to make:

* **Insert**: Insert mode pushes new objects to Salesforce and doesn't update them as they change in your data source.

{% hint style="warning" %}
If an attribute of an object that has already been synchronized has been updated, the object's initial line in Salesforce **will not be modified nor deleted.** A new line will be created, with old and new information.
{% endhint %}

* **Update**: Update mode updates fields on existing objects in Salesforce. If an object is not recognized in Salesforce, it is not created (and therefore not updated).
* **Upsert**: Upsert mode pushes new objects to Salesforce and updates fields that changed in your data source.

This means that when you set up your synchronization, you need to know whether you have new data to add (*insert*), old data to update (*update*) or a combination of both (*upsert*).

#### Fields mapping

In the Fields mapping section, you are asked to specify the field contained in your DinMo model corresponding to the some identifiers in your Salesforce account.

{% hint style="warning" %}
If you select *Upsert* or *Update* mode, the field "Object ID" is required. It will be used to link the model's records to existing objects.
{% endhint %}

In this section, you can also add as many attributes mapping as you would like. DinMo will keep the values of all the attributes mapped here up to date (if *Upsert* or *Update* modes chosen).

{% hint style="danger" %}
The data type of the field of interest must be the same in DinMo and in Salesforce, otherwise data for this attribute cannot be sent.
{% endhint %}

<figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2FD5kKxVWM5aPng9teSSfU%2Fimage.png?alt=media&#x26;token=298fd297-79a4-470d-8978-008f4a17bd0e" alt="" width="563"><figcaption><p>Salesforce fields mapping</p></figcaption></figure>

:bulb: DinMo can't create new attributes. If needed, you can always create new ones directly in Salesforce, by clicking on the gear icon in the top right:

<figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2Fpw3FgdfDaSTyte1480wt%2FCleanShot%202025-06-09%20at%2017.25.20%402x.png?alt=media&#x26;token=f0561be7-320c-4319-b03e-784fb2303337" alt=""><figcaption></figcaption></figure>

#### Scheduling options

Define how frequently your data is sent into Salesforce CRM.

Depending on the activation mode, the behavior of each new synchronization will be different:

|                 | Insert mode                                                                                                              | Update mode                                                                                                            | Upsert mode                                                                                                           |
| --------------- | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Description** | At each new synchronization, DinMo will insert new lines for each new object or for an object with new attribute values. | Update mode updates attributes on existing objects in Salesforce.                                                      | Upsert mode pushes new objects to Salesforce and updates fields that have changed in your data source since last run. |
| **Use Case**    | You want to push new objects into Salesforce without needing the data within each object to stay up to date              | You want to enrich existing objects in Salesforce (with new attributes/updated ones) without creating any new objects. | You want to push objects into Salesforce and want to keep the data up-to-date.                                        |

#### Warnings

In this section, specify if you want to receive warning for your Salesforce activation.

{% hint style="info" %}
Consult the specific section to [learn more about sync warnings](https://docs.dinmo.io/activations/troubleshooting-syncs/sync-warnings).
{% endhint %}

<figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2FbHkENNZNI9DqdBTsIXE4%2Fimage.png?alt=media&#x26;token=00623ffe-f020-4391-9d14-50e7c2df4096" alt=""><figcaption></figcaption></figure>
