Skip to content
CRM · Two-way sync platform

Nutshell integration.

Connect your Nutshell workflow to the systems your business runs on. Work with a Stacksync engineer to confirm the connection and required operations, starting with Companies, People and Leads.

  • Review your systems with an integration engineer
  • Get a scoped implementation and validation plan

Adopted by fast-scaling companies moving mission-critical data in real time

Case study
Migrated from MuleSoft
Case study
Migrated from Celigo
Migrated from Heroku Connect
Migrated from Matillion
Case study
Migrated from Fivetran
Case study
Migrated from Celigo
Record types

Nutshell records to discuss.

These Nutshell record examples help scope a technical review. They are not a list of verified Stacksync operations.

Leads
Retain the lead ID and record its relationship to any converted contact or company.
People
Use a stable person/contact ID and an explicit cross-system lookup. Email can change and can be shared, so treat it as a matching clue rather than a universal key.
Companies
Retain the source company ID and the destination customer/company ID. Separate legal entities, subsidiaries, and business units; a shared name or web domain is insufficient.
See 3 more record examples
Activities
Keep the source event ID, source system, occurrence time, and ingestion time. Use an explicit duplicate-detection key.
Tasks
Use a stable task/work-item ID and preserve its project or parent-ticket reference.
Notes
Identify this record type and the operation you need to review with Stacksync.
Connection setup

Nutshell connection requirements.

Review Nutshell access and the operations your workflow needs with Stacksync. The vendor API reference below can help your administrator prepare for that discussion.

Prepare access and scope for the engineering review
  • Identify the Nutshell account, edition, environment, and business objects the integration must access.
  • Confirm a Stacksync connector or implementation path for Nutshell, including read/write support, authentication, and initial-load limits.

Integration design

Match records and fields for your Nutshell integration.

Choose the owner of customer details, qualification, and commercial status separately. A customer update, a won deal, and an approved order represent different business decisions.

Use these design questions to prepare a representative record and the business rules your integration must preserve.

Explore record matching and field-mapping checks
NutshellSource record IDKeep the account and record type
Record matchingSource ID ↔ destination IDLink the same record across systems
Selected destinationDestination record IDPreserve its local key and rules
Conceptual identity model. Keep source and destination IDs linked so an update reaches the right record. Confirm the supported sync direction separately.
Match the same record in both systems
Retain the source company ID and the destination customer/company ID. Separate legal entities, subsidiaries, and business units; a shared name or web domain is insufficient.
Load related records in the right order
Resolve parent organizations, business units, and currency references before dependent transactions.

Mapping checks by record type

Companies

Confirm object support with Stacksync

Identity
Retain the source company ID and the destination customer/company ID. Separate legal entities, subsidiaries, and business units; a shared name or web domain is insufficient.
Fields to consider
Source record ID · Legal or display name · Business-unit reference · Lifecycle status
Related records to resolve first
Resolve parent organizations, business units, and currency references before dependent transactions.
Test before going live
Use two organizations with similar names and one with multiple business units. Verify that an update reaches the intended entity only.

People

Confirm object support with Stacksync

Identity
Use a stable person/contact ID and an explicit cross-system lookup. Email can change and can be shared, so treat it as a matching clue rather than a universal key.
Fields to consider
Source person ID · Display name · Email address · Organization reference · Consent state
Related records to resolve first
Resolve the organization relationship and any owner or consent references required by the destination.
Test before going live
Test an email change, two records sharing an email, and a person associated with multiple organizations.

Leads

Confirm object support with Stacksync

Identity
Retain the lead ID and record its relationship to any converted contact or company.
Fields to consider
Source lead ID · Qualification status · Owner reference · Conversion reference
Related records to resolve first
Resolve owner and campaign references and decide how conversion changes the identity relationship.
Test before going live
Convert a test lead after the first load and verify that it does not create a duplicate person or orphan its activity.

Products

Confirm object support with Stacksync

Identity
Distinguish the product ID, variant ID, SKU, and price-list entry; they are not interchangeable keys.
Fields to consider
Source product ID · SKU or variant reference · Description · Unit of measure · Price-list reference
Related records to resolve first
Resolve units, variants, categories, and applicable price lists before order lines.
Test before going live
Test two variants of one product, a changed SKU, and a price that applies to only one market or currency.

Activities

Confirm object support with Stacksync

Identity
Keep the source event ID, source system, occurrence time, and ingestion time. Use an explicit duplicate-detection key.
Fields to consider
Source event ID · Event type · Occurred-at time · Related record ID · Payload version
Related records to resolve first
Resolve the related customer, user, or transaction identity without assuming the event ID is the entity ID.
Test before going live
Deliver the same event twice, then an older event after a newer one; verify duplicate and ordering behavior.

Tasks

Confirm object support with Stacksync

Identity
Use a stable task/work-item ID and preserve its project or parent-ticket reference.
Fields to consider
Source task ID · Parent reference · Assignee · Status · Due date
Related records to resolve first
Resolve project, user, and parent-item references before the task.
Test before going live
Test a reassignment, an unsupported status transition, a deleted parent, and a due date across time zones.

Download the field-mapping workbook (CSV) to capture the actual API fields, matching keys, owners, and test results. Use it as you build with your team or a Stacksync engineer.

Setup and validation

Validate the Nutshell integration in four steps.

A changed contact detail updates the existing person; a sales-state change reaches only the downstream process approved to act on it.

View the four setup tests and expected results

  1. Verify Nutshell credentials and resource scope

    After confirming an implementation path, validate the selected access method with the intended account, region or workspace, and resource scope. Record the credential owner and renewal procedure, then demonstrate access to one selected object.

    Expected result: The selected resource is accessible through the approved credential, with the renewal and revocation procedure assigned to an owner.

  2. Test record matching for Companies

    Using the implementation established in the compatibility review, preserve the selected source ID and resolve the required references. Use two organizations with similar names and one with multiple business units. Verify that an update reaches the intended entity only.

    Expected result: A changed contact detail updates the existing person; a sales-state change reaches only the downstream process approved to act on it.

  3. Test the operation your workflow needs

    Review one Nutshell record with a Stacksync engineer. Confirm how it should reach the other system, how often it must update, and whether your workflow needs reads, creates, or updates. Test those operations before expanding the integration.

    Expected result: The selected operation is confirmed, addresses the intended record, and exposes rejected values for repair.

  4. Test recovery and name the support owner

    For the confirmed implementation, interrupt a non-production transfer and restore access. Establish whether recovery uses the current source state or a stored historical event, and verify that repeated delivery preserves record identity.

    Expected result: The records have the expected current values, repeated delivery creates no duplicate business record, and your team knows who handles unresolved errors.

Use the production-readiness checklist to record test results, assign support owners, and agree on when to go live.

Troubleshooting

Troubleshoot your Nutshell integration.

Diagnose record matching, delayed changes, and rejected operations
A Nutshell record appears under the wrong destination record
Retain the source company ID and the destination customer/company ID. Separate legal entities, subsidiaries, and business units; a shared name or web domain is insufficient. Resolve parent organizations, business units, and currency references before dependent transactions. Repair the ID relationship before repeating the operation.
The first load looks correct but later results differ
Confirm the selected Nutshell implementation’s change-detection method for Companies, People and Leads. Compare later changes with the original source rather than using a successful initial copy as evidence of ongoing capture.
One operation succeeds while another is rejected
Check the specific Nutshell object, field permissions, required references, and allowed operation. A successful read does not establish that a create, update, deletion, or business action is available.

Review retry, replay, and recovery behavior before repeating an operation that may already have succeeded.

Review your Nutshell workflow with an engineer

Nutshell integration guides

FAQ

Nutshell connector FAQ

How should I plan an integration with Nutshell?

Choose the owner of customer details, qualification, and commercial status separately. A customer update, a won deal, and an approved order represent different business decisions. Confirm the connection and read/write operations with Stacksync. Start with one workflow, agree on which fields each system owns, then test initial data, later changes, and recovery before expanding.

Can the Nutshell connector write changes back?

Write-back support is not established for this connection. Review the Nutshell records and fields you need with a Stacksync engineer, then test the required operation with a representative record.

Which identifiers should I preserve for Nutshell data?

Retain the source company ID and the destination customer/company ID. Separate legal entities, subsidiaries, and business units; a shared name or web domain is insufficient.

Which related records should I load first for Nutshell?

Resolve parent organizations, business units, and currency references before dependent transactions.

How do I validate Nutshell changes after the initial load?

Use two organizations with similar names and one with multiple business units. Verify that an update reaches the intended entity only. A changed contact detail updates the existing person; a sales-state change reaches only the downstream process approved to act on it.

What will we cover in a Nutshell integration demo?

Start with one workflow and a sample record from Companies, People and Leads. We can review how to identify the record, connect related data, set the update direction, and test recovery. Include the person who owns the source system and anyone who will maintain the integration; you do not need a finished requirements document.

Explore Nutshell connections

Choose the other system in your workflow. Each guide explains the connection options, available operations, field mapping, and setup checks for that pair.

168 integration guides

CRM · 31

ERP · 25

Database · 12

Data warehouse · 9

Business productivity · 28

Accounting and finance · 12

AI · 4

Analytics · 6

Communications · 6

E-commerce · 6

Human resources · 11

Marketing · 8

Security and identity · 6

Storage · 4

SECURITY

Security teams trust Stacksync

As a data company, we understand the importance of keeping your data secure. Stacksync is built with security best practices to keep your data safe at every layer, and is DPF-certified for US, EU, UK and CH data transfers.

Learn more about security
SOC 2 Type II
ISO 27001
HIPAA BAA
GDPR
CCPA
DPF US-EU-UK-CH
→ SECURITY WITH BENEFITS

SSO & SCIM

Let your users access Stacksync from your centralized user management systems. Works with Okta, Azure, Google SSO and more.

Alerts

Immediately get alerted about record syncing issues over email, Slack, PagerDuty and WhatsApp. Resolve issues from a centralized dashboard with retry and revert options.

Secure connection options

Securely connects to your systems with:

OAuth 2SSH TunnellingSSL certificatesIP WhitelistingVPN gatewayVPC peeringand more
Coworkers laughing in front of a laptop in a casual office setting

Connect the systems your business runs on.
Build your next workflow with Stacksync.

Book a demo Get started