Salesforce REST API

API Endpoints

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'])

Related APIs