Salesforce Integration — Package Setup and Configuration

Last updated 2026-11-16

Overview

The Salesmotion Salesforce integration is an enterprise-grade solution delivered as a managed package installed directly into your Salesforce org. Combined with a dedicated integration user, this architecture gives your team full control over the data flow between Salesmotion and Salesforce — while keeping setup straightforward and maintenance minimal. For an overview of what your reps see in Salesforce, see Salesmotion + Salesforce.

Plans: The Salesforce managed package integration is available on every plan. It is included with the Enterprise plan; on other plans, contact us and we switch it on for your workspace.

What makes it enterprise-grade

The Salesmotion Salesforce integration is designed for organisations that need reliability, security, and full control:

  • Managed package — Installed via Salesforce's standard package installation process. Your Salesforce admin has full visibility into what the package does and can manage it like any other installed package.
  • Dedicated integration user — A named Salesforce user handles all data sync between the two platforms. This gives your admin complete control over permissions, audit trails, and data access — no shared credentials or background processes operating outside your visibility.
  • Full customer-side control — Your Salesforce admin controls which objects, fields, and records are shared. Nothing is synced without your explicit configuration.
  • Easy to set up — Despite being enterprise-grade, the installation takes minutes. Most teams are fully configured and syncing data within a single session.

Installation

Step 1: Install the managed package

The package adds the Salesmotion Insights Lightning component to Salesforce. To get the installation link:

Then:

  1. Open the link. It opens the standard Salesforce package installer.
  2. Choose whether to install for all users or specific profiles (we recommend starting with admin-only, then expanding once you've verified the setup).
  3. Click Install.
  4. In Salesforce Setup, add https://app.salesmotion.io to your Trusted URLs and tick the frame-src (iframe content) option, so the component can load Salesmotion.
  5. Add the Salesmotion Insights component to your pages in the Lightning App Builder:
    • Account, Opportunity, Contact and Lead record pages show the matching Salesmotion account. Contacts and Opportunities use their Account; Leads use the Lead's website.
    • The Home page shows the Salesmotion feed. Use Default Feed View to start on Account Signals or Contact Signals.
    • Use Height of the card to set how tall the component is.

Step 2: Create the integration user

The integration user is a dedicated Salesforce user account that handles all API calls between Salesmotion and your Salesforce org.

  1. Create a new user in Salesforce with a descriptive name (e.g. "Salesmotion Integration").
  2. Give the user a permission set with access to Accounts and the View Roles and Role Hierarchy system permission.
  3. Ensure the user has read/write access to the Account and Contact objects, plus Opportunity or Account Plan if you want to sync those. If your team will add contacts to Salesforce from Salesmotion, the user also needs to create Leads.
  4. In Salesmotion, a workspace admin opens Settings → Integrations, clicks Connect on the Salesforce card (or Connect (Sandbox) for a sandbox org), and signs in to Salesforce as the integration user. No passwords are shared with Salesmotion.

The integration user appears in your Salesforce audit log, so your admin can always see exactly what data is being read or written. The Status section of the Salesforce Settings page shows the connected user's email.

Step 3: Configure sync direction

The Salesmotion integration supports both one-way and bi-directional sync:

DirectionWhat it doesBest for
Salesmotion → Salesforce (one-way)Pushes Salesmotion intelligence (signals, scores, summaries) into Salesforce custom fields. Writes only to the fields you map.Teams that want to enrich Salesforce with account intelligence without any data flowing back.
Bi-directionalSalesmotion intelligence flows into Salesforce, and Salesforce data (account ownership, custom fields, opportunity data) flows back to Salesmotion.Teams that want full alignment between both platforms — account assignments, pipeline data, and intelligence all in sync.

You set the direction for each field in Settings → Integrations → Salesforce, under Field Mapping. Each mapping's Sync value is either Salesmotion to CRM or CRM to Salesmotion. Switch a row to Active to sync it. For a CRM to Salesmotion field, switch on Filterable to filter your accounts by it in Salesmotion.

Choose the direction that fits your workflow. Most teams start with Salesmotion → Salesforce (one-way) and expand to bi-directional once they're comfortable with the integration.

What gets synced

Salesmotion → Salesforce

Once configured, Salesmotion syncs every 12 hours, and an admin can start a sync at any time with the Sync button on the Salesforce settings page. It pushes the following into your Salesforce account records:

  • Salesmotion Score — The account's current intelligence score (0–100), updated as new signals are detected.
  • Signal summaries — Key Insights, Opportunities, Challenges, People Updates, Top News, and Talking Points, written to the Account fields you map.
  • Account briefs — AI-generated "What You Need to Know" summaries available directly within Salesforce.
  • Data points — Signal counts by type and time period (30/90/180 days), plus contact moves over 3, 6, and 12 months, visible on the Account record.

Salesmotion embedded in Salesforce showing the account overview with Fast Facts, What You Need to Know sections, and the Salesmotion Insights sidebar with Opportunities and Account Plans Salesmotion intelligence embedded directly in Salesforce — your reps see deep account research, signals, and AI-generated insights without leaving the CRM.

Salesforce → Salesmotion

When bi-directional sync is enabled:

  • Account ownership — Salesforce account owners are synced to Salesmotion (matched to Salesmotion users by email), so filtering by "My Accounts" works automatically.
  • Custom fields — Map any Salesforce fields (industry, segment, ARR, renewal date) into Salesmotion for richer context.
  • Opportunity data — Salesmotion can display pipeline information alongside account intelligence.

Salesmotion data points and What You Need to Know section within Salesforce, plus Activity History showing integration activity Salesmotion data points, AI-generated insights, and selling guidance embedded within the Salesforce Account record — everything your reps need at the point of work.

The Salesforce Settings page

Once Salesforce is connected, Settings → Integrations → Salesforce has these sections:

SectionWhat it does
StatusShows whether Salesforce is connected, the Salesforce objects Salesmotion can see, and the connected user.
Primary CRMOnly when HubSpot is connected too. An admin picks which CRM is used for Add to CRM, Quick Links and importing accounts.
AccountsWhich Salesforce Accounts are imported (synced owners, a list view, a report or a checkbox field), importing specific Accounts, adding new Salesmotion accounts to Salesforce automatically, and removal. See Importing accounts from your CRM.
Field MappingWhich fields sync, and in which direction.
Add to SalesforceWhether users may add accounts and contacts to Salesforce. Off by default.
Adding contacts to SalesforceWhat happens when a contact already exists in Salesforce (same email).
Contact fieldsWhich Contact and Lead fields Add to CRM fills. See Mapping contact fields to your CRM.
Sync logEvery sync, with the fields and owners that changed, the accounts imported and the accounts added to Salesforce.

Salesmotion never deletes anything in Salesforce. Use Sync at the top of the page to sync straight away, and Disconnect to stop the integration.

The embedded experience

With the managed package installed, Salesmotion surfaces directly within your Salesforce interface as a Lightning component. Your reps see:

  • Salesmotion Insights panel — A sidebar or embedded section showing the account's latest intelligence, including summaries, signals, and opportunities.
  • What You Need to Know — AI-generated briefings with Key Insights, Executive Perspective, Opportunities, Challenges, and Talking Points — all within the Salesforce Account record.
  • Data points dashboard — Signal counts across time periods, so reps can see at a glance how active an account is.
  • Quick navigation — Jump to the full Salesmotion account view for deeper research when needed.

This means reps never need to leave Salesforce to access Salesmotion intelligence. Deep account research is available at the point of work.

See it in action

Watch how the Salesmotion Salesforce integration works:

Security and compliance

The Salesforce integration is built with enterprise security requirements in mind:

  • Your data stays in your control. The integration user model means your Salesforce admin has full visibility and control over data access.
  • No background access. All API calls are made by the named integration user, visible in standard Salesforce audit logs.
  • Standard Salesforce security. The managed package respects your org's sharing rules, field-level security, and profile permissions.
  • SOC 2 compliant. Salesmotion's infrastructure meets SOC 2 requirements for data handling and security.

For organisations with formal IT review processes, we provide integration architecture documentation covering data flow, authentication, encryption, and compliance. Contact your account manager to request this for your security review.

Getting started

On the Enterprise plan, setting up the Salesforce integration is part of onboarding. On other plans, contact us first and we switch it on. Then:

  1. Install the managed package with the link in Step 1, and add the component to your pages.
  2. Create the integration user and connect it in Settings → Integrations.
  3. Configure field mappings and sync direction, and choose which accounts to import in Accounts.
  4. Verify the setup — check that Salesmotion intelligence appears on your Salesforce Account records.

The entire process typically takes less than an hour. Your Salesmotion Customer Success Manager will guide you through each step.

Adding contacts and accounts from Salesmotion

Once Salesforce is connected, admins can let users add contacts (as Contacts under the linked Account, or as Leads) and accounts to Salesforce straight from Salesmotion. It's off by default: switch it on in Settings → Integrations → Salesforce → Add to Salesforce. By default, a contact that already exists in Salesforce only gets its empty fields filled. See Adding contacts and accounts to your CRM and Mapping contact fields to your CRM.

Frequently asked questions

How long does the installation take?

The managed package installs in minutes. End-to-end setup — including creating the integration user, configuring field mappings, and verifying sync — typically takes less than an hour.

Can I control exactly what data is synced?

Yes. Your Salesforce admin controls which fields are mapped and which direction data flows. Nothing is synced without explicit configuration.

Does the integration affect Salesforce performance?

No. The integration uses standard Salesforce APIs and respects governor limits. The managed package is lightweight and does not impact your org's performance.

Can I switch between one-way and bi-directional sync?

Yes. You can start with one-way sync and expand to bi-directional at any time. An admin can change the Sync direction on any field mapping, or your Salesmotion account manager can help you adjust the configuration.

What happens if I uninstall the managed package?

Uninstalling the package removes the Salesmotion components from Salesforce. Any data that was synced into standard or custom fields remains in Salesforce — no data is deleted. You can reinstall and reconnect at any time.

Is the integration available on all Salesforce editions?

The integration works with Salesforce Enterprise Edition and above. It requires API access, which is included with Enterprise, Unlimited, and Performance editions of Salesforce.

See it in action

Take a 2-minute tour

New to Salesmotion? Walk through the interactive demo — no signup required.

Try the interactive demo →
Still need help?

Talk to the team

Email us with a question, or book 30 minutes with the team to see Salesmotion on your accounts.