Salesforce REST API Reference

API Endpoints

Method	Endpoint	Description
GET	`/sobjects`	List all available SObjects (Account, Contact, Lead, etc.)
GET	`/sobjects/Account`	Get Account object metadata and field definitions
GET	`/sobjects/Account/{id}`	Retrieve a specific Account record by ID, returning all accessible fields for that record.
POST	`/sobjects/Account`	Create a new Account record with fields in the request body; returns the created record ID.
PATCH	`/sobjects/Account/{id}`	Update an existing Account record by ID; provide only the fields to modify in the request body.
DELETE	`/sobjects/Account/{id}`	Delete an Account record by ID; the record is moved to the Recycle Bin for recovery.
GET	`/query?q={soql}`	Execute a SOQL query (e.g., SELECT Id, Name FROM Account)
GET	`/sobjects/Lead`	Get Lead object metadata including field definitions, picklist values, and record types.
POST	`/sobjects/Lead`	Create a new Lead record with required fields (LastName, Company); returns the created Lead ID.
GET	`/sobjects/Opportunity`	Get Opportunity object metadata including field definitions, stage picklist values, and relationships.
POST	`/sobjects/Opportunity`	Create a new Opportunity record; requires Name, StageName, and CloseDate fields in the request body.
GET	`/search?q={sosl}`	Full-text search across all objects using SOSL

Reach developers actively building with Salesforce. See live pageview data and self-serve checkout — your slot goes live in minutes.

View inventory & pricing →

Code Examples

# Authenticate and get access token
curl -X POST https://login.salesforce.com/services/oauth2/token \
  -d "grant_type=password" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "username=YOUR_USERNAME" \
  -d "password=YOUR_PASSWORD"

# Query accounts
curl https://yourInstance.salesforce.com/services/data/v60.0/query \
  -G --data-urlencode "q=SELECT Id, Name, Industry FROM Account LIMIT 10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Create a new lead
curl -X POST https://yourInstance.salesforce.com/services/data/v60.0/sobjects/Lead \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"FirstName":"John","LastName":"Doe","Company":"Acme Corp"}'

// Authenticate
const authRes = await fetch('https://login.salesforce.com/services/oauth2/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    grant_type: 'password',
    client_id: CLIENT_ID,
    client_secret: CLIENT_SECRET,
    username: USERNAME,
    password: PASSWORD,
  }),
});
const { access_token, instance_url } = await authRes.json();

// Query accounts
const query = 'SELECT Id, Name, Industry FROM Account LIMIT 10';
const res = await fetch(
  `${instance_url}/services/data/v60.0/query?q=${encodeURIComponent(query)}`,
  { headers: { Authorization: `Bearer ${access_token}` } }
);
const { records } = await res.json();
console.log(records);

import requests

# Authenticate
auth = requests.post('https://login.salesforce.com/services/oauth2/token', data={
    'grant_type': 'password',
    'client_id': CLIENT_ID,
    'client_secret': CLIENT_SECRET,
    'username': USERNAME,
    'password': PASSWORD,
})
token = auth.json()
access_token = token['access_token']
instance_url = token['instance_url']

# Query accounts
query = 'SELECT Id, Name, Industry FROM Account LIMIT 10'
res = requests.get(
    f'{instance_url}/services/data/v60.0/query',
    params={'q': query},
    headers={'Authorization': f'Bearer {access_token}'}
)
print(res.json()['records'])

Use Salesforce from Claude / Cursor / ChatGPT

Get a hosted MCP endpoint for Salesforce. Paste your Salesforce API key, copy back one URL, drop it into Claude Desktop, Cursor, or any AI client that supports remote MCP. Your AI calls Salesforce directly with your credentials — no local install, works on mobile.

query_salesforce Execute a SOQL query and return results

create_lead Create a new lead with name, company, and email

update_opportunity Update opportunity stage, amount, or close date

search_contacts Full-text search across all contacts

get_account Retrieve account details by ID or name

Connect in 60 seconds

Paste your Salesforce key → get an MCP URL → paste into Claude/Cursor. Hosted by IOX, encrypted at rest.

Connect Salesforce to your AI →

Salesforce REST API

API Endpoints

Sponsor this page

Code Examples

Use Salesforce from Claude / Cursor / ChatGPT

Connect in 60 seconds

Related APIs