Salesforce Connector
Prerequisites
- A Salesforce account (any edition: Essentials, Professional, Enterprise, Unlimited)
- System Administrator profile or a user with "API Enabled" permission
Authentication
Salesforce uses OAuth 2.0. Landed handles the OAuth flow automatically.
Step 1: Connect via OAuth
- In Landed, click Add Connector and select Salesforce
- Click Connect to Salesforce
- You will be redirected to the Salesforce login page
- Log in with your Salesforce credentials
- Click Allow to grant Landed access
- You will be redirected back to Landed
Note: The Salesforce user must have the "API Enabled" permission. This is included in most standard profiles but may be disabled for custom profiles.
Step 2: Verify API Access
If you get an error during OAuth, verify API access is enabled:
- In Salesforce, go to Setup > Users > Profiles
- Find the profile assigned to your user
- Under Administrative Permissions, ensure API Enabled is checked
Required Permissions
The connected Salesforce user needs:
| Permission | Purpose |
|---|---|
| API Enabled | Access the Salesforce REST API |
| View All Data (recommended) | Read all records across the org |
If the user doesn't have "View All Data", Landed will only sync records the user has access to based on Salesforce's sharing model.
Available Streams
| Stream | Description | Sync Mode |
|---|---|---|
accounts | Company/organization records | Incremental |
contacts | People/contact records | Incremental |
opportunities | Sales opportunities/deals | Incremental |
leads | Lead records | Incremental |
tasks | Activity tasks | Incremental |
events | Calendar events | Incremental |
cases | Support cases | Incremental |
users | Salesforce users | Incremental |
campaigns | Marketing campaigns | Incremental |
campaign_members | Campaign membership records | Incremental |
Salesforce Editions and API Limits
| Edition | API Calls per 24h | Notes |
|---|---|---|
| Essentials | 15,000 | API access may require add-on |
| Professional | 15,000 | API access may require add-on |
| Enterprise | 100,000 | API access included |
| Unlimited | 100,000+ | API access included |
Landed is designed to be efficient with API calls, using bulk API where possible. You can monitor API usage in Salesforce under Setup > Company Information.
Common Errors
| Error | Cause | Fix |
|---|---|---|
INVALID_SESSION_ID | Token expired or revoked | Disconnect and reconnect in Landed |
API_DISABLED_FOR_ORG | API not enabled for your edition | Contact Salesforce to enable API access or upgrade your edition |
INSUFFICIENT_ACCESS | User lacks View All Data | Grant View All Data permission or use a System Administrator profile |
REQUEST_LIMIT_EXCEEDED | Daily API limit reached | Wait 24 hours or contact Salesforce to increase limits |
Data Notes
- Salesforce uses its own ID format (18-character alphanumeric). These are preserved as-is.
- Custom fields are included in syncs. Custom objects can be synced by contacting Landed support.
- Salesforce data is returned in UTC timezone.
- Deleted records are captured via Salesforce's "IsDeleted" flag.