> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Salesforce record

> Update fields on an existing Salesforce record from a Workflow action.

The Update Salesforce Record action updates one or more fields on an existing Salesforce record. Use it to push AI-generated summaries back to the CRM, sync deal notes, or update contact information based on [Workflow](/workflows/overview) results.

<Steps>
  <Step title="Add the Update Salesforce Record action">
    While editing a Workflow, click the **+** button between existing steps. Select **Update Salesforce Record** from the action list to add it to your Workflow.

    <Frame>
      <img src="https://mintcdn.com/cassidy/S3C8nlCeFAZnY2mJ/images/reference/update-salesforce-record-img-0.png?fit=max&auto=format&n=S3C8nlCeFAZnY2mJ&q=85&s=c06293eadc10c476c72f609122c4d47b" alt="Adding the Update Salesforce Record action from the action picker" width="848" height="446" data-path="images/reference/update-salesforce-record-img-0.png" />
    </Frame>
  </Step>

  <Step title="Connect your Salesforce account">
    If you haven't already, connect your Salesforce account to Cassidy. This allows Cassidy to access your Salesforce records and update them from your Workflow.

    <Frame>
      <img src="https://mintcdn.com/cassidy/S3C8nlCeFAZnY2mJ/images/reference/update-salesforce-record-img-1.png?fit=max&auto=format&n=S3C8nlCeFAZnY2mJ&q=85&s=c47248ffc5927b1395e2a7bbabf2d387" alt="Salesforce connection prompt in the action configuration" width="792" height="546" data-path="images/reference/update-salesforce-record-img-1.png" />
    </Frame>
  </Step>

  <Step title="Rename the action (optional)">
    If you want to make the action more descriptive or easier to reference as a variable later, enter a new name in the action title field.
  </Step>

  <Step title="Select the record type">
    Use the **Type** dropdown to choose the Salesforce object type you want to update — for example, **Lead**, **Contact**, **Opportunity**, **Account**, **Task**, **User**, **Case**, or a custom object.

    <Frame>
      <img src="https://mintcdn.com/cassidy/S3C8nlCeFAZnY2mJ/images/reference/update-salesforce-record-img-2.png?fit=max&auto=format&n=S3C8nlCeFAZnY2mJ&q=85&s=4754426c08530c72c4e44254fb531a0e" alt="Type dropdown in the Update Salesforce Record action" width="788" height="186" data-path="images/reference/update-salesforce-record-img-2.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/S3C8nlCeFAZnY2mJ/images/reference/update-salesforce-record-img-3.png?fit=max&auto=format&n=S3C8nlCeFAZnY2mJ&q=85&s=5d529f65d4e1f3a90202f66cd4c34643" alt="Expanded list of Salesforce object types" width="504" height="438" data-path="images/reference/update-salesforce-record-img-3.png" />
    </Frame>
  </Step>

  <Step title="Define search criteria">
    Under **Fields to search by**, click **Add Condition** to specify how to find the record you want to update. Select the field to search on, choose the operation (equals, contains, etc.), and enter the value to match. You can add multiple conditions — they combine with AND logic, so only records matching all conditions are returned. The action updates the first matching record.

    <Frame>
      <img src="https://mintcdn.com/cassidy/S3C8nlCeFAZnY2mJ/images/reference/update-salesforce-record-img-4.png?fit=max&auto=format&n=S3C8nlCeFAZnY2mJ&q=85&s=17821b741efc58d9ebc4e7679ada4e76" alt="Search criteria configuration with field, operation, and value" width="772" height="346" data-path="images/reference/update-salesforce-record-img-4.png" />
    </Frame>

    <Tip>Use variables from your trigger or previous steps as search values — for example, reference a record ID from the trigger to find the exact record to update.</Tip>
  </Step>

  <Step title="Map fields to update">
    Under **Fields to update**, click **+ Add Field**, select the Salesforce field (key) to update, and map the new value from a variable or static text. Repeat to update multiple fields. Click the trash icon next to a field mapping to remove it.

    <Frame>
      <img src="https://mintcdn.com/cassidy/S3C8nlCeFAZnY2mJ/images/reference/update-salesforce-record-img-5.png?fit=max&auto=format&n=S3C8nlCeFAZnY2mJ&q=85&s=27e2eac8258290b38c13b18d40451240" alt="Field mapping showing key-value pairs for fields to update" width="780" height="328" data-path="images/reference/update-salesforce-record-img-5.png" />
    </Frame>
  </Step>
</Steps>

## Related

* [Look Up Salesforce Record](/integrations/salesforce/look-up-record)
* [Find or Create Salesforce Record](/integrations/salesforce/find-or-create-record)
* [Salesforce Record Created trigger](/integrations/salesforce/record-created-trigger)
* [Salesforce for Workflows](/integrations/salesforce/workflows)
