Help CenterPlatform · Settings

CRM Connection Detail

Manage one CRM connection: connect, import or start fresh, choose what syncs, send a test contact, and watch sync health.

Updated Jul 2, 2026 9 steps 13 questions answeredOpen this page in the platform
On this page

Overview

This is the detail page for one CRM connection (Salesforce, HubSpot, Pipedrive, or Zoho CRM), reached from the Integrations hub by clicking Manage on a CRM card. From here you connect or reconnect the CRM, decide whether to import your existing contacts, choose what syncs, optionally set a default record owner, send a test contact to prove it works, and watch sync health. A guided setup checklist walks you through the first-time steps. Sync is one way: SalesHive only adds and updates records in your CRM, it never deletes anything.

How to use this page

  1. Follow the setup guide

    A guided checklist sits at the top of the page and tracks your progress: connect the CRM, choose your starting point, review your field mapping, and prove it works with a test contact. Completed steps get a check mark and the current step is highlighted. The Review your field mapping step has an Open Field Mapping button that jumps you straight to the right tab. Once all four are done it says Setup complete and you can dismiss the guide with the X in its top corner (it stays hidden on future visits).

  2. Connect the CRM

    If you are not connected yet, click Connect and sign in with your CRM credentials. For Zoho only, pick your Datacenter first (United States, Europe, India, Australia, or Japan) so the sign-in points at the right region. When the connection is live the status reads Connected and shows the account it is linked to.

  3. Choose whether to import your existing contacts

    Right after connecting, a one-time choice appears: Import all your existing SalesHive contacts into the CRM now, or Skip and only sync new activity going forward. Skipping is safe and reversible, so start fresh if you are not sure. You can run the import later any time with Resync existing contacts.

  4. Pick what syncs

    Under What gets synced, four toggles control what SalesHive pushes: contacts, emails, calls, and meetings. They default to on. Turn off anything you do not want mirrored into your CRM. SalesHive pushes matching new activity on the next scheduled sync, which runs every 5 minutes.

  5. Set an optional record owner

    When your CRM supports it, a Record owner section lets you assign the records SalesHive creates to a specific person on your team. This applies to new records only, so re-assignments you make in your CRM always stick. Leave it unset to use your CRM's own assignment rules.

  6. Send a test contact

    Once connected, click Send a test contact to push one clearly labeled record (named "SalesHive Sync Test") straight into your CRM using the real sync path. In a few seconds you get a confirmation with how long it took and a link to open the record in your CRM. It is safe to delete, and clicking again updates the same record rather than making a duplicate. This is the fastest way to prove the connection is working end to end.

  7. Check the last 24 hours

    The Last 24 hours card summarizes what SalesHive pushed to your CRM in the past day in plain English: how many records Synced, how many are Waiting or skipped, and how many Failed. If everything is clean it says so. If anything failed, you get a plain-language card for each problem type explaining what it means and how to fix it, plus a Retry failed records button that re-queues them for the next sync.

  8. Read the common questions

    A Common questions section near the bottom answers what clients ask most when connecting a CRM: whether SalesHive can delete data, duplicate contacts, how fast activity shows up, why new custom fields appear, how to send a fixed value like a lead source, and who gets assigned new records. Click any question to expand its answer.

  9. Review recent sync activity

    The Recent sync activity table lists the last 50 events with when they happened, the type, the outcome (success, skipped, or failed), the CRM's record id, and any error message. Use it to confirm records are landing and to spot anything that failed.

What the buttons do

Open Field Mapping (setup guide)
In the setup checklist, jumps to the Integrations hub Field Mapping tab with this CRM already selected.
Dismiss setup guide
The X on the setup checklist. Hides the guide for this CRM; it stays hidden on future visits.
Connect / Reconnect
Starts the CRM sign-in (OAuth). Reads Reconnect if a previous connection needs re-authorizing.
Datacenter (Zoho only)
Picks which Zoho region your CRM lives in (US, Europe, India, Australia, or Japan) before sign-in.
Import N contacts
Runs the one-time import that mirrors your existing SalesHive contacts into the CRM.
Skip, only sync new activity
Skips the initial import and starts fresh, so only new activity syncs from now on. Reversible via Resync.
Sync toggles
Four on/off switches for contacts, emails, calls, and meetings. Control what SalesHive pushes to the CRM.
Assign new records to
Optional owner picker. Assigns records SalesHive creates to a chosen CRM user; affects new records only.
Send a test contact
Pushes one labeled test record into your CRM through the live sync path and returns a link to it. Re-clicking updates the same record, never a duplicate.
Retry failed records
Appears in the Last 24 hours card when something failed. Re-queues the failed records to retry on the next sync (within about 5 minutes).
Resync existing contacts
Re-pushes your existing contacts to the CRM. Also the way to run the import after you skipped it. Disabled while an import is running.
Disconnect
Stops all pushes to the CRM after a confirmation. Existing CRM records are left untouched and you can reconnect any time.

Common questions

No. Sync is one way from SalesHive into your CRM, and SalesHive only adds and updates records. It never deletes anything. Disconnecting stops new pushes but leaves existing records in place.
Click Send a test contact on the status card. SalesHive pushes one record named "SalesHive Sync Test" into your CRM through the real sync path and gives you a link to open it, usually within a few seconds. It is safe to delete, and clicking again just updates the same record.
A plain-English summary of what SalesHive pushed to your CRM in the past day: how many records synced, how many are waiting or were skipped, and how many failed. If anything failed you get a card per problem type explaining what it means and how to fix it, plus a Retry failed records button.
Read the explanation card in the Last 24 hours section, which says what went wrong and how to fix it (for example, add a field your CRM is asking for). After fixing the cause, click Retry failed records to re-queue them for the next sync. Your existing CRM records are never touched in the meantime.
Either is fine. Import if you want your current SalesHive contacts mirrored into the CRM right away. Skip to start fresh and only sync new activity. Skipping is reversible, so you can run the import later with Resync existing contacts.
Every 5 minutes. SalesHive pushes any matching new activity for the sync types you have toggled on during the next scheduled run.
Yes. Open Field Mapping (the setup guide links straight to it), choose Add a field, and pick A fixed value. Set the value (for example, SalesHive) and the CRM field it should land in, and every synced contact gets stamped with it.
SalesHive adds a couple of custom fields to your contact records (like "SalesHive External ID") to prevent duplicates and keep the sync reliable. They are harmless and are handy for filtering which records came from SalesHive.
It optionally assigns records SalesHive creates in your CRM to a specific person on your team. It applies only when a record is first created, never on updates, so any owner changes you make in your CRM stick. Leave it unset to use your CRM's own assignment rules. The setting appears only when your CRM connection can list its users.
If your CRM rejects the connection (for example, a revoked or expired login), SalesHive marks it disconnected and automatically alerts your strategist so it gets reconnected quickly. The status here will read Disconnected with the reason, and you can click Reconnect to restore it. Nothing already synced is lost.
The status shows an error with the last error message below it. Read the message, fix the issue in your CRM if needed (for example, adding a field it asks for), then use Reconnect or Resync. SalesHive keeps your existing CRM records untouched the whole time.
Success means the record was pushed to your CRM. Skipped means SalesHive intentionally did not push it yet (for example, an email whose contact is not synced). Failed means the push errored, and the reason shows in the Error column.
Click Disconnect and confirm. SalesHive stops pushing new contacts and activity, your existing CRM records are not deleted, and you can reconnect any time.

Prefer it done for you?

Everything in these guides is work SalesHive can run for you: US-based SDRs and AI agents working your campaigns, calls, and inbox on one platform.

Explore the platform