REST API Developer Guide - Version 68.0 - Quick reference

Sep 12, 2026

REST API Developer Guide (v68.0) provides a structured walkthrough for building and operating integrations using Salesforce’s REST interface. It covers core architecture, authentication options with external client apps or connected apps via OAuth 2.0, and practical request/response topics including headers, query options, compression, and conditional requests. The guide also explains status codes and error responses, API deprecation and end-of-life policy, plus quick-start steps and concrete examples for objects, records, metadata, searches, queries, blobs, and authorization-related workflows.

LanguageEnglish

CategoryPresentations

FormatPDF

Pages410

Reading Time2 h 24 min

AccessFree to download

Chapter 1: Introduction to REST API

About REST API

Release Notes

Supported Editions and Required Permissions

REST Resources and Requests

REST API Architecture

Authorization Through External Client Apps or Connected Apps and OAuth 2.0

Headers

Send REST Requests with cURL

Valid Date and DateTime Formats

Status Codes and Error Responses

API End-of-Life Policy

Chapter 2: Quick Start

Using cURL

Step One: Sign up for Salesforce Developer Edition

Step Two: Set Up Authentication

Step Three: Walk Through the Sample Code

Using Other Tools

Chapter 3: Examples

Getting Information About My Organization

Working with Object Metadata

Working with Records

Working with Searches and Queries

REST API Developer Guide Version 68.0, Winter ’27 Last updated: September 11, 2026 © Copyright 2000–2026 Salesforce, Inc. All rights reserved. Salesforce is a registered trademark of Salesforce, Inc., as are other names and marks. Other marks appearing herein may be trademarks oftheir respective owners. CONTENTS Chapter 1: Introduction to REST API ........................................ 1 About REST API ....................................................... 2 Release Notes ........................................................ 2 Supported Editions and Required Permissions .................................. 2 REST Resources and Requests ............................................. 3 REST API Architecture ................................................... 5 Authorization Through External Client Apps or Connected Apps and OAuth 2.0 ............ 6 Headers ............................................................ 7 Assignment Rule Header ............................................. 8 Call Options Header ................................................ 9 Compression Headers .............................................. 9 Conditional Request Headers ......................................... 10 Duplicate Rule Header .............................................. 12 Limit Info Header .................................................. 12 MRU Header .................................................... 13 Package Version Header ............................................ 14 Query Options Header .............................................. 14 Warning Header .................................................. 14 Send REST Requests with cURL ............................................ 15 Valid Date and DateTime Formats .......................................... 15 Status Codes and Error Responses ......................................... 16 API End-of-Life Policy ................................................... 18 Chapter 2: Quick Start ................................................ 19 Using cURL ......................................................... 20 Step One: Sign up for Salesforce Developer Edition .............................. 20 Step Two: Set Up Authentication ........................................... 21 Step Three: Walk Through the Sample Code ................................... 23 Using Other Tools .................................................... 28 Chapter 3: Examples ................................................ 29 Getting Information About My Organization ................................... 30 List Available REST API Versions ........................................ 30 List Org Limits .................................................... 34 List Available REST Resources ......................................... 38 Get a List of Objects ................................................ 40 Get a List of Objects If Metadata Has Changed .............................. 41 Working with Object Metadata ............................................ 42 Get Metadata for an Object .......................................... 42 Contents Get Field and Other Metadata for an Object ............................... 43 Get Object Metadata Changes ........................................ 44 Working with Records .................................................. 45 Create a Record .................................................. 46 Update a Record ................................................. 47 Delete a Record .................................................. 48 Get Field Values from a Standard Object Record ............................ 49 Get Field Values from an External Object Record by Using the Salesforce ID .......... 49 Get Field Values from an External Object Record by Using the External ID Standard Field .......................................................... 50 Get a Record Using an External ID .....

FAQs

How is authorization handled for Salesforce REST API requests?

Authorization is done through external client apps or connected apps using OAuth 2.0, with required permissions and setup steps covered in the guide’s quick start.

Which REST headers does the guide describe?

The guide covers standard and specialized headers such as assignment rule, call options, compression, conditional request headers, duplicate rule, limit info, MRU, package version, query options, and warning headers.

What kinds of examples are included for REST API usage?

Examples include retrieving organization information, listing versions and resources, working with object metadata and records (create/update/delete and upsert), executing SOQL queries, searching, and handling blob and related workflows.

Sep 12, 2026

Upload by Alex Sinclair