Salesforce: Update Record
Controlled node
Overview
Updates an existing Salesforce record using the Salesforce API. This node requires a Salesforce connection, the API name of the sObject, the ID of the record to update, and an object containing the fields to change.
Use this node when a workflow needs to enrich, correct, or synchronize an existing Salesforce record from workflow data.
Prerequisites
You must configure a Salesforce connection in your project settings before using this node. The connection is selected via the Connection property in the node panel.
Inputs
| Input | Type | Description | Default |
|---|---|---|---|
| Run | Event | Triggers the record update. | - |
| sObject API Name | Text | The API name of the Salesforce object to update, such as Account, Contact, Lead, or a custom object API name. | - |
| Record ID | Text | The Salesforce ID of the existing record to update. | - |
| Data | Data | An object containing the field values to update, such as { "Industry": "Technology" }. | - |
| Connection | Connection | The Salesforce connection to use for the API call. | - |
Outputs
| Output | Type | Description |
|---|---|---|
| Done | Event | Fires when the update operation has completed, regardless of success or failure. |
| Result | Data | The Salesforce update result on success, or an error object if validation or the API call fails. |
Runtime Behavior and Defaults
- Controlled Node: The node runs only when the Run event fires.
- Project Requirement: A runtime project ID is used with the selected Salesforce connection.
- Connection Validation: If Connection is missing, Result contains
{ "error": "Connection is required" }. - sObject Validation: If sObject API Name is missing, Result contains
{ "error": "sObject API Name is required" }. - Record Validation: If Record ID is missing, Result contains
{ "error": "Record ID is required" }. - Data Validation: Data must be an object. If it is missing or not an object, Result contains
{ "error": "Data must be a valid object" }. - Error Handling: Salesforce API errors are returned through Result as an error object containing the error message.
Example Usage
Update an Account
- Connect a Start node or another event source to Run.
- Set sObject API Name to
"Account". - Set Record ID to the Salesforce record ID you want to update.
- Connect a Dictionary node or AI Write Data output to Data.
- Select the Salesforce Connection in the node panel.
- Connect Result to Show or branch on the result in downstream logic.
Example update payload:
{
"Industry": "Technology",
"BillingCity": "London"
}
tip
Use Salesforce: Describe sObject to inspect available fields before building the update payload, especially for custom objects or fields.