Skip to main content

​
Overview

Contact sync lets you configure CRM sync rules for contacts once, in one place, instead of rebuilding them inside every bridge. Once it’s set up, any contact your team enriches — from a Buyer page, Ask Starbridge, MCP, or a bridge — can be synced to your CRM automatically, using the rules you define here.
Screenshot 2026 06 30 At 4 54 38 PM
Contact sync serves as an org-wide default: configure it once, and unlock your team’s ability to sync contacts to the CRM from Starbridge.This article describes the initial admin setup. For the builder experience using contact sync once it’s configured by the admin, see Sync contacts to your CRM.

​
Before you start

You’ll need:
  • A Salesforce or HubSpot integration connected. See Connect your CRM.
  • Account matching completed. Contact sync requires you to associate a contact to a valid CRM account, so Starbridge doesn’t create orphaned contact records in your CRM. See Account matching.
The Contact object enabled in your CRM integration, with the following fields synced to Starbridge:
  • Required standard fields: first name, last name, email, the account/company association field, phone, salutation, and job title.
  • Required custom fields:
    • Starbridge Contact ID (text) — Starbridge’s unique identifier for every contact. Enables lookups by Starbridge contact identifier and helps admins identify which contacts were created or modified by Starbridge.
    • Starbridge Is Active (boolean) — whether Starbridge considers the contact currently active. Defaults to true for active contacts; set to false when Starbridge detects the contact is no longer employed at the account.
    • See Step 1 of Connect your CRM for step-by-step instructions on creating these custom fields.
These fields significantly improve deduplication accuracy and let Starbridge maintain accounts and contacts up to date in your CRM over time.

​
Set credit limits for your Consumer users

Once you configure Contact sync, your Consumer users will see the option to enrich and sync new contacts directly from a Buyer page or Ask Starbridge — respecting the lookup and sync rules you define here. Enriching a contact consumes 2 credits. Once a contact has been enriched by anyone in your org, it’s available to your whole team from then on — you’ll never be charged twice for the same contact, whether enriched from the Buyer page, MCP, Ask Starbridge, or a Bridge. See How do credits work? for more detail. Before configuring Contact sync, consider whether you want to modify your per-user credit limits for your Consumer-role users. The default limit for Consumer users is 100 credits, or 50 enriched contacts. You can set your preferred limit in bulk from Settings → Organization Settings → Users — select your Consumer users, then Set credit limit.

​
Step 1: Open the Contact sync tab

Go to Settings → Integrations, open your CRM integration, and click the Contact sync tab. If you have more than one CRM connected, Contact sync is configured independently per integration.
Screenshot 2026 06 30 At 4 58 28 PM 1
If the prerequisites above aren’t met yet, the Configure sync button stays disabled.

​
Step 2: Configure sync

Click Configure sync. This creates your org’s Contact sync bridge and requires you to set up its Contact lookup and Contact sync columns before you can do anything else on this tab — Starbridge can’t show you a useful contact list until it knows how to find and write CRM records.

​
Contact lookup

This determines whether a contact already exists in your CRM, so the sync column knows whether to create a new record or update an existing record. Contact lookup is configured by default with recommended lookup rules:
  • Lookup by Starbridge Contact ID. If Starbridge previously created or updated this Contact record in your CRM, it will stamp the record with a unique identifier to ensure accurate lookups moving forward.
    • This lookup rule is required. If you do not see a custom field for Starbridge Contact ID:
      • Make sure you create the custom field on the Contact object in your CRM. See Step 1 of Connect your CRM for step-by-step instructions.
      • Double-check your Objects and fields configuration and confirm you have toggled on the Starbridge Contact ID field to sync it from your CRM to Starbridge.
  • Lookup by normalized email and account ID. Matches a CRM contact whose email matches the contact’s email, scoped to the contact’s already-matched CRM account — the most reliable match when an email is on file. Starbridge normalizes email formatting to ensure matches are as accurate as possible.
  • Lookup by first name, last name, and account ID. Falls back to matching on full name within the same matched account, for contacts that don’t have an email on file.
  • Lookup by last name, phone, and account ID. Falls back further to matching on last name and phone number within the same matched account, so a contact’s phone number can resolve a match even without an email or a full name match. Starbridge normalizes phone formatting to ensure matches are as accurate as possible.
We recommend proceeding with these default recommended lookup rules. Most admins do not modify the recommended default rules or add new rules.

​
Contact sync

This is what actually creates or updates the CRM Contact record. A few things to set: Field mappings. We recommend: Starbridge Contact ID and Is Active are the two exceptions to “Write if Empty” — you want Starbridge to keep these current every time it syncs, since they’re what it uses to maintain accurate lookups and contact hygiene over time.
You can map custom fields, like Lead Source, to custom values after this initial configuration step.Saving your initial configuration here won’t trigger any syncs. You can add custom field mappings — like Lead Source — after this step, before any records are created or updated in your CRM.
Run conditions. Starbridge requires Sync to CRM to be true. This is the toggle you can flip on when you’re ready to sync a given contact to your CRM. Starbridge also requires the Account lookup column’s Record ID to not be empty, because Starbridge will not create orphan contacts in your CRM. Orphan contacts are contacts without an associated account. Optionally, you can also require email or phone to not be empty if you want to avoid creating sparse CRM records.

​
Step 3: Choose which contacts sync

Once configured, the Contact sync tab lists every contact your org has ever enriched — across bridges, Buyer pages, Ask Starbridge, the Chrome extension, and MCP — along with where it was enriched, who enriched it, and its current sync state.
Screenshot 2026 06 30 At 4 55 59 PM
Each row has a Sync to CRM toggle. Turning it on starts syncing that contact immediately (provided it meets your run conditions); turning it off stops syncing it but doesn’t delete it from your CRM. You can also select multiple rows and sync, resync, or unsync them in bulk from the action bar at the bottom of the table.

​
What your reps see

Once Contact sync is configured, contact cards on Buyer pages and in Ask Starbridge show a Sync to CRM action. Reps don’t interact with anything described above — all they need to do is click a button to enrich the contact and sync it to your CRM using the rules you set here. If a sync can’t go through, the card explains why in plain language (for example, no matched CRM account) instead of just failing.

​
Troubleshooting

Check its run conditions. The Sync to CRM is required to sync, but you may have additional run conditions that aren’t satisfied and prevent sync.
Contact sync stays hidden from consumers until an admin has configured it for at least one CRM integration.

​
What’s next

Sync contacts to your CRM

Build custom lookup and sync logic inside a single bridge instead of using the org-wide default.

Account matching

Review and approve the CRM account matches Contact sync depends on.

How do credits work?

Understand credit consumption and how to set per-user limits.