All tools

Create a record

Creates a record of any object, such as a Lead, Contact or Opportunity, and returns its new ID.

View on GitHub
Updated Sep 27, 2026Available asMCPCLIAPI

Description

Replace `sObject` with the object's API name, such as `Lead`, and send the field values in the body; the call fails if a required field is missing. Every call runs as the signed-in user, within their object permissions and field-level security.

create-record.md

Create a record

Creates a record of any object, such as a Lead, Contact or Opportunity, and returns its new ID.

Replace sObject with the object's API name, such as Lead, and send the field values in the body; the call fails if a required field is missing. Every call runs as the signed-in user, within their object permissions and field-level security.

Set up

Use the first option your agent supports.

MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

{ "mcpServers": { "salesforce": { "url": "https://api.salesforce.com/platform/mcp/v1/platform/sobject-mutations" } } }

Call the MCP tool createSobjectRecord.

Server URL: https://api.salesforce.com/platform/mcp/v1/platform/sobject-mutations

CLI (official)

Install the command, then confirm it runs.

npm install @salesforce/cli --global
sf --version

Run sf data create record.

API (official)

Before doing anything else, make one read-only call to confirm access.

Rules

  • Ask the user before anything that sends messages, costs money, or changes data.
  • Never print API keys.

Built from these files in the repository

The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.

Ways in

RouteSourceCallRequiredDocs
MCPOfficial · remotecreateSobjectRecordOAuthDocs
CLIOfficialsf data create recordOAuthDocs
APIOfficialPOST /services/data/vXX.X/sobjects/sObject/OAuthDocs

Workflows using Create a record

No workflows yet
No published workflow uses Create a record yet.