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

# Update Record

> Write enriched or computed values back to records in a connected integration

Writes data back to a connected integration. Use it to update existing records with enriched, normalized, or computed values.

<Frame caption="Update Record node - entity, description, and field mapping with Mentions">
  <img src="https://mintcdn.com/bondata/DlMd45I1zc1MvbNc/images/guide/nodes/actions/update-record.png?fit=max&auto=format&n=DlMd45I1zc1MvbNc&q=85&s=b38e8100d086bf953e90eed0887939ce" width="600" height="406" data-path="images/guide/nodes/actions/update-record.png" />
</Frame>

## Configuration

| Setting                 | Description                                                                     |
| ----------------------- | ------------------------------------------------------------------------------- |
| **Entity**              | The target entity to update (e.g., Salesforce Account)                          |
| **Description**         | A human-readable summary using Mentions (shown in task logs)                    |
| **Fields to Update**    | Map target fields to source values using Mentions                               |
| **Do it automatically** | Toggle to execute immediately when the Agent runs, or queue for manual approval |

## How It Works

<Steps>
  <Step title="Select the target entity">
    Choose which entity's records to update in the connected integration.
  </Step>

  <Step title="Map fields">
    Use **+ Add Column** to add field mappings. For each field, select the target field and use **Mentions** to set the value from upstream data.
  </Step>

  <Step title="Set execution mode">
    Toggle **Do it automatically** to execute immediately, or leave it off to queue tasks for manual approval.
  </Step>
</Steps>

## Output

Each matched record creates one task. Tasks are visible in the Agent's task log after execution.

## Best Practices

* Start with **manual approval** to verify updates before enabling automatic execution
* Use a clear **Description** with Mentions so task logs are easy to scan
* Map only the fields that need updating - avoid overwriting unchanged data

## Related Nodes

* **[Create Record](/guide/nodes/actions/create-record-node)** - creates new records instead of updating existing ones
* **[Get Data](/guide/nodes/data/get-data-node)** - fetches the records that Update Record will modify