Salesforce - Nango Docs

🚀 Quickstart

Connect to Salesforce with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Salesforce.

Authorize Salesforce

Go to Connections -> Add Test Connection -> Authorize, then log in to Salesforce. Later, you’ll let your users do the same directly from your app.

Call the Salesforce API

Let’s make your first request to the Salesforce API (fetch a list of contacts). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/services/data/v58.0/query?q=SELECT+Id,FirstName,LastName,Email+FROM+Contact+LIMIT+10" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/services/data/v58.0/query',
    params: { q: "SELECT Id,FirstName,LastName,Email FROM Contact LIMIT 10" },
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Salesforce Integration Guides

Nango maintained guides for common use cases.

How do I link my account?
Connect your Salesforce account
How to register your own Salesforce OAuth app
Register an OAuth app with Salesforce and obtain credentials to connect it to Nango

Official docs: Salesforce API docs

🧩 Pre-built syncs & actions for Salesforce

Enable them in your dashboard. Extend and customize to fit your needs.

Composite

Function name	Description	Type	Source code
`composite-batch-request`	Execute multiple independent Salesforce REST subrequests in one batch call	Action	🔗 Github
`composite-graph-request`	Execute a dependent graph of subrequests in one composite graph call. Supports up to 500 subrequests across multiple graphs with automatic rollback on failure.	Action	🔗 Github
`composite-request`	Execute multiple Salesforce REST subrequests in one composite call.	Action	🔗 Github

Identity

Function name	Description	Type	Source code
`get-current-user`	Retrieve the current Salesforce user and org identity context.	Action	🔗 Github

Limits

Function name	Description	Type	Source code
`get-limits`	Retrieve current org API usage and platform limits	Action	🔗 Github

Metadata

Function name	Description	Type	Source code
`describe-global`	List available sObject types and global metadata for the org.	Action	🔗 Github
`describe-sobject`	Retrieve schema metadata for a specific sObject type	Action	🔗 Github
`get-sobject-basic-info`	Retrieve basic metadata for a specific sObject type including object properties, recent items, and URIs for related resources.	Action	🔗 Github

Query

Function name	Description	Type	Source code
`query-all-records`	Run a SOQL query that also includes deleted and archived records.	Action	🔗 Github
`query-records`	Run a SOQL query and return matching records	Action	🔗 Github
`retrieve-query-more`	Continue a SOQL query using a nextRecordsUrl locator	Action	🔗 Github

Quick Actions

Function name	Description	Type	Source code
`list-quick-actions`	List quick actions available in the org or on an sObject	Action	🔗 Github

Recent Items

Function name	Description	Type	Source code
`list-recent-items`	List recently viewed records visible to the authenticated user	Action	🔗 Github

Records

Function name	Description	Type	Source code
`create-record`	Create a Salesforce sObject record for a specified object type.	Action	🔗 Github
`delete-record`	Delete a Salesforce sObject record by type and record ID.	Action	🔗 Github
`get-record-by-external-id`	Retrieve a record by external ID field and value.	Action	🔗 Github
`get-record`	Retrieve a Salesforce record by object type and record ID	Action	🔗 Github
`update-record-by-external-id`	Update a record by external ID field and value.	Action	🔗 Github
`update-record`	Partially update a Salesforce record by object type and record ID.	Action	🔗 Github
`upsert-record`	Create or update a Salesforce record using an external ID field.	Action	🔗 Github

Resources

Function name	Description	Type	Source code
`list-available-resources`	Discover supported Salesforce REST resource versions and root URLs.	Action	🔗 Github

SObject Collections

Function name	Description	Type	Source code
`create-sobject-collection`	Create multiple sObject records in one collection request.	Action	🔗 Github

Search

Function name	Description	Type	Source code
`parameterized-search-records`	Run a parameterized search request across Salesforce objects.	Action	🔗 Github
`search-records`	Run a SOSL search across searchable Salesforce objects	Action	🔗 Github

sObject Collections

Function name	Description	Type	Source code
`delete-sobject-collection`	Delete multiple records in one sObject collection request.	Action	🔗 Github
`update-sobject-collection`	Update multiple records in one sObject collection request	Action	🔗 Github
`upsert-sobject-collection`	Upsert multiple records using external IDs in one collection request	Action	🔗 Github

Others

Function name	Description	Type	Source code
`get-quick-action-defaults`	Retrieve default field values for a quick action	Action	🔗 Github
`accounts`	Sync Salesforce Account records with a practical default field set	Sync	🔗 Github
`articles`	Sync Salesforce knowledge articles with title, content, and modified timestamps	Sync	🔗 Github
`cases`	Sync Salesforce Case records with common service and status fields.	Sync	🔗 Github
`contacts`	Sync Salesforce Contact records with a practical default field set	Sync	🔗 Github
`opportunities`	Sync Salesforce Opportunity records with amount, stage, close date, and owner fields.	Sync	🔗 Github
`records-by-soql`	Sync arbitrary Salesforce records from a caller-provided SOQL query	Sync	🔗 Github
`tickets`	Sync Salesforce case tickets with core fields and related conversation context.	Sync	🔗 Github
`users`	Sync Salesforce User records with profile, email, and active state fields.	Sync	🔗 Github

​🚀 Quickstart

​📚 Salesforce Integration Guides

​🧩 Pre-built syncs & actions for Salesforce

​Composite

​Identity

​Limits

​Metadata

​Query

​Quick Actions

​Recent Items

​Records

​Resources

​SObject Collections

​Search

​sObject Collections

​Others