Using components: Salesforce Destination

Use the Salesforce destination component to store the output of a data flow in Salesforce Sales cloud object.

The destination component uses Salesforce Bulk API.


Select an existing Salesforce connection or create a new one (for more information, see Allowing Xplenty access to my data on Salesforce.)

Destination Properties

  • Target object - select the name of the target object in your Salesforce org. By default, if the table doesn't exist, it will be created automatically.

Operation type

Append (Insert only) - default behavior. Data will only be appended to the target object. Note that you can't insert data into the internal id field.

Upsert - inserts new data into the object and updates existing data according to the selected upsert key.
Upsert key - when operation type is upsert, you must map a key field and select it as the upsert key. This can be either the internal id field, or an external key field. The external key should not allow duplicate values.

Delete - deletes data in the destination object by Salesforce internal id field.

Advanced options

  • Batch size - number of records that are inserted to Salesforce in each batch (default 1000).
  • Maximum errors - maximum number of errors to tolerate when inserting data into Salesforce. Note that the actual number of errors may be greater than the maximum due to the parallel nature of the process.

Schema Mapping

Map the dataflow fields to the target object fields. When using the insert operation, fields defined as mandatory in the object must be mapped to input fields. When using the upsert operation, you should map the mandatory fields if you expect to insert data. If you use the internal id field as the upsert key, make sure to use null in the mapped field's value for new records. When using the delete operation, the internal id field must map to an input field.