---
ref: tool:salesforce/create-record
name: Create a record
company: company:salesforce
workflows: []
access: [mcp, cli, api]
tags: [capability:manage-crm, category:crm, has:api, has:cli, has:mcp]
docs: https://developer.salesforce.com/docs/platform/api-rest/guide/resources-sobject-basic-info-post.html
updated: 2026-09-27
---

# 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.

```json
{ "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.

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

Run `sf data create record`.

### API (official)

- Base URL: https://{MyDomainName}.my.salesforce.com
- Endpoint: `POST /services/data/vXX.X/sobjects/sObject/`
- Auth: OAuth; sign in when the agent asks
- Docs: https://developer.salesforce.com/docs/platform/api-rest/guide/intro-rest.html

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.