Salesforce Custom Data Syncs in NetSuite Connector

Configure one-way syncs between supported NetSuite records and Salesforce objects, with manual or AI-suggested mappings and automatic processing.

·3 min read·NetSuite 2026.2·View Oracle Docs

Custom data syncs let administrators connect supported NetSuite records and Salesforce objects when prebuilt Salesforce Connector flows do not meet their needs. Each sync runs in one direction. Configuration includes field mappings, optional AI mapping suggestions, automatic processing, and a Post Record action to synchronize and verify a record.

When Should You Use a Custom Data Sync?

Custom data syncs provide an alternative when a prebuilt Salesforce Connector flow does not meet your integration needs. Each sync runs either from NetSuite to Salesforce or from Salesforce to NetSuite; a single custom sync is not bidirectional. Decide which application supplies the data and which receives it before configuring mappings.

For broader context on Connector synchronization, see NetSuite Connector data syncs. Keep the configuration steps below scoped to Salesforce Connector.

What Must Be Ready Before Configuration?

You need:

  • A licensed NetSuite Connector Platform account with a valid Salesforce connection.
  • Access to the Salesforce objects and fields used by the sync.
  • Permission to configure data flows and view metadata for the selected NetSuite records and Salesforce objects.

For Salesforce custom objects, configure an available field with both required properties:

Field propertyRequired configuration
External IDConfigure the available field as External ID
UniqueConfigure that same field as Unique

Setting only one property does not satisfy the requirement. Check both before testing a sync involving a Salesforce custom object.

How Do You Configure and Verify a Custom Sync?

In Salesforce Connector, go to Settings > Data Flows > Custom Data Sync. On the Data Mappings page, open the Custom Record Types tab.

Configure field mappings there, or click Suggest Field Mappings with AI to add suggested mappings. As a validation practice, review suggestions against the intended source and destination fields rather than treating them as confirmed business rules.

Select Post Record to synchronize and verify a record. A configured sync can also be enabled for automatic processing. Consider verifying a representative record before enabling automatic processing; that ordering is a recommendation, not a documented prerequisite.

Who This Affects

  • Administrators configuring flows: Confirm licensing, connection access, and configuration permissions.
  • Teams responsible for Salesforce access: Confirm object and field access, plus both required properties for custom-object fields.
  • Integration teams: Assess whether supported records and objects meet needs that prebuilt flows cannot address.

For related release context, consult the NetSuite 2026.2 release-note updates.

Key Takeaways

  • Each custom sync operates in one direction only.
  • Field mappings can be configured manually or added through AI suggestions.
  • Salesforce custom objects require an available field configured as both External ID and Unique.
  • Post Record synchronizes and verifies a record; configured syncs can be enabled for automatic processing.

Frequently Asked Questions (4)

Can one custom data sync send records in both directions between NetSuite and Salesforce?
No. Each custom sync runs in one direction only: either NetSuite to Salesforce or Salesforce to NetSuite. Decide which application is the source and which is the destination before configuring field mappings.
What access and licensing are required to configure a Salesforce custom data sync?
You need a licensed NetSuite Connector Platform account with a valid Salesforce connection. You also need access to the Salesforce objects and fields involved, plus permission to configure data flows and view metadata for the selected NetSuite records and Salesforce objects.
What Salesforce field settings are required when syncing a custom Salesforce object?
An available field on the Salesforce custom object must be configured as both External ID and Unique. Setting only one of these properties does not meet the requirement.
How can I test a custom data sync before enabling automatic processing?
In Salesforce Connector, go to Settings > Data Flows > Custom Data Sync, open the Custom Record Types tab, and configure or review the field mappings. Select Post Record to synchronize and verify a record; you can also enable the configured sync for automatic processing.

Weekly Update History (1)

NetSuite Connectoradded

Added an entry for Custom Data Syncs Between NetSuite and Salesforce.

View Oracle Docs
Source: Custom Data Syncs Between NetSuite and Salesforce — Oracle NetSuite Help Center. This article was generated from official Oracle documentation and enriched with additional context and best practices.

Was this article helpful?

More in Integration

View all Integration articles →

Also from NetSuite 2026.2

View all NetSuite 2026.2 changes →