View as Markdown
Salesforce icon

Salesforce ACTION

Update Record

Update a Salesforce record of any object type. Only the fields you supply change; everything else is left as-is. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Salesforce account once, then configure and run Update Record from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "salesforce_rest_api-update-record",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    salesforce_rest_api: { authProvisionId: "apn_xxxxxxx" },
    sobjectType: "Object Type",
    recordId: "Record ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Update Record inputs
Property Type Description
sobjectType Object Type string
The Salesforce object API name to update (e.g. Account, Contact, Opportunity). Prop name preserved to avoid breaking existing configs.
Required
recordId Record ID string
The ID of the record to update (Salesforce's 15- or 18-character record ID, e.g. 001XX000003DHP0 for an Account). Use SOQL Query to find the ID if you only have the record name.
Required
fields Fields object
Field name -> new value pairs. Only include fields you want to change. Example: {"StageName": "Closed Won", "Amount": 75000}. Use Describe Object to discover valid field names.
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
salesforce_rest_api-update-record
Version
1.0.1
App
Salesforce
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes