Skip to main content
Connecting your CRM is the first step in the CRM integration setup. Once connected, Starbridge can match your accounts to Starbridge buyers, sync territories, and push and pull data through lookup and sync columns in your Bridges.
This step requires Starbridge Admin access.
1

Add recommended fields to your CRM objects

Before integrating your CRM to Starbridge, we strongly recommend adding the following custom fields to your CRM Account and Contact objects
  • Starbridge Account ID (text) — Starbridge’s unique identifier for every account. Enables lookups by Starbridge account identifier and helps admins identify which accounts were created or modified by Starbridge.
  • 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.
These fields aren’t required, but they significantly improve deduplication accuracy and let Starbridge maintain accounts and contacts up to date in your CRM over time.Account field: Starbridge Account ID
Before connecting Starbridge to Salesforce, you need to create a custom field on the Account object to store Starbridge data.
  1. In Salesforce, click the Gear icon (⚙) → Setup
    Salesforce Setup menu
  2. In the left sidebar, search for Object Manager and open it, or directly click Objects and Fields → Object Manager
    Object Manager in sidebar
  3. Click Account → Fields & Relationships → New
    Screenshot 2026 06 15 At 6 20 04 PM
  4. Create the field — Starbridge Account ID:
    Screenshot 2026 06 15 At 6 21 31 PM
    Click Next → Next → Save.
Salesforce automatically appends __c to custom field API names (e.g. Starbridge_Account_ID__c). This is expected.
Before connecting Starbridge to HubSpot, you need to create a custom property on the Company object to store Starbridge data.
  1. In HubSpot, go to Settings (Gear icon ⚙) → Properties
    HubSpot Settings - Properties
  2. In the Select an object dropdown, select Company properties, then click Create property (top right)\
    Screenshot 2026 06 15 At 6 26 07 PM
  3. Create the property — Starbridge Account ID:
    Screenshot 2026 06 15 At 6 26 52 PM

    Click Create.
Do not delete this property after creation. HubSpot will not allow you to recreate it with the same configuration.
Contact fields: Starbridge Contact ID and Starbridge Is Active
Before connecting Starbridge to Salesforce, you need to create two custom fields on the Contact object to store Starbridge data.
  1. In Salesforce, click the Gear icon (⚙) → Setup
    Salesforce Setup menu
  2. In the left sidebar, search for Object Manager and open it, or directly click Objects and Fields → Object Manager
    Object Manager in sidebar
  3. Click Contact → Fields & Relationships → New
    Fields and Relationships - New
  4. Create the first field — Starbridge Contact ID:
    Screenshot 2026 06 15 At 6 03 33 PM 1

    Click Next → Next → Save & New
  5. Create the second field — Starbridge Is Active:
    Screenshot 2026 06 15 At 6 05 51 PM
    Click Next → Next → Save.
Salesforce automatically appends __c to custom field API names (e.g. Starbridge_Contact_ID__c). This is expected.
Before connecting Starbridge to HubSpot, you need to create two custom properties on the Contact object to store Starbridge data.
  1. In HubSpot, go to Settings (Gear icon ⚙) → Properties
    HubSpot Settings - Properties
  2. In the Select an object dropdown, select Contact properties, then click Create property (top right)
    Select Contact properties and Create property
  3. Create the first property — Starbridge Contact ID:
    Starbridge Contact ID property settings
  4. Create the second property — Starbridge Is Active:
    Starbridge Is Active property settings
Do not delete these properties after creation. HubSpot will not allow you to recreate them with the same configuration.
2

Choose who will connect your CRM

The Salesforce or HubSpot account used to connect Starbridge to your CRM determines who owns the integration.Salesforce: We strongly recommend creating a dedicated API-only integration user rather than connecting as a personal admin account. This keeps your audit trail clean (all Starbridge writes are attributed to one system user, not a person), limits permissions to only what Starbridge needs, and ensures the connection isn’t disrupted by team changes.HubSpot: HubSpot’s OAuth model ties the connection to the account rather than an individual user, so there’s no equivalent integration user setup.
We strongly recommend connecting Starbridge using a dedicated API-only integration user rather than a personal admin account. This allows you to easily track Starbridge’s changes, retain the ability to roll back changes easily, and scope permissions to only what Starbridge needs. Most Salesforce Enterprise, Unlimited, and Performance orgs include up to 5 free Salesforce Integration user licenses.
  1. In Salesforce, click the Gear icon (⚙) → Setup\
    Screenshot 2026 06 16 At 9 47 34 AM
  2. Navigate to Users → Users → click New User and fill in the required fields:\
    Screenshot 2026 06 16 At 9 48 52 AM
Screenshot 2026 06 16 At 10 04 04 AM

Click Save. Check your email and verify the new integration user account in the Salesforce verification email.
Screenshot 2026 06 16 At 10 05 03 AM
  1. Create a Permission Set for the integration user:
    • Go to Setup → Permission Sets → New
      Screenshot 2026 06 16 At 10 10 10 AM
    • Label: Starbridge API Integration
    • License: Salesforce API Integration
    • Click Save
      Screenshot 2026 06 16 At 10 12 29 AM
  2. In the Permission Set named Starbridge API Integration, open Object Settings and enable at minimum:
    Screenshot 2026 06 16 At 10 13 33 AM
    Screenshot 2026 06 16 At 10 15 09 AM
    Screenshot 2026 06 16 At 10 22 56 AM
    • To grant object access, click Edit and check the checkboxes listed above under Object Permissions.
    • To grant field access, check the Read Access and Edit Access checkboxes to select all fields at once under Field Permissions. In the Permission Set named Starbridge API Integration:
  • Open System Permissions
Screenshot 2026 06 16 At 10 46 26 AM
  • Click Edit
Screenshot 2026 06 16 At 10 47 20 AM
  • Scroll down to Approve Uninstalled Connected Apps and check the checkbox
Screenshot 2026 06 16 At 10 48 31 AM
  • Scroll back up and click Save
Screenshot 2026 06 16 At 10 48 46 AM
  1. Assign the Permission Set to the integration user:
  • Go to Setup → Users
  • Click the integration user’s name (go to the letter ‘I’ for Integration, Starbridge)
    Screenshot 2026 06 16 At 10 37 54 AM
  • Assign the Starbridge API Integration permission set:
    • Hover over Permission Set Assignments
    • Click Edit Assignments
      Screenshot 2026 06 16 At 10 39 40 AM
    • Scroll down and select Starbridge API Integration from the Available Permission Sets, then click Add
      Screenshot 2026 06 16 At 10 40 21 AM
    • Click Save
      Screenshot 2026 06 16 At 10 40 50 AM
  1. Log in as the integration user before connecting to Starbridge:
    • Log out of your current account in Salesforce
    • Log in to Salesforce using the Starbridge API Integration user username (not your personal email) and password
    • Once you log in, you will not be able to access the Salesforce UI, since you are logged in as an API only integration user. This is expected.
      Don’t have a password? Check your email for a verification email from Salesforce. Verify your integration user account to create a password. Save this password in a secure place.
  2. Proceed with the steps described below in Starbridge.
Starbridge uses OAuth and does not store your Salesforce username or password.
Unlike Salesforce, HubSpot doesn’t have a dedicated integration user concept — the connection is made via OAuth and persists at the account level. Any admin with sufficient permissions can connect Starbridge. We recommend connecting as an admin or Super Admin with access to at minimum the Company, Contact, Owner, and Deal objects.
  1. Log into HubSpot as an admin or Super Admin
  2. Proceed with the steps below.
Starbridge uses OAuth and does not store your HubSpot username or password.
3

Navigate to the CRM integration

Go to Settings → Integrations, click Create, and select Salesforce or HubSpot.
If you want to connect a sandbox before connecting production, connect to a sandbox instance first. Starbridge supports separate sandbox and production connections.
4

Authenticate

Log into your Salesforce or HubSpot account when prompted.
The user you connect must have permission to read and write the objects you want Starbridge to access. Most teams use an admin user or a dedicated integration user to keep audit trails clean. See the instructions above under Choose who will connect your CRM > Step-by-step instructions for Salesforce.
Salesforce only: Salesforce has introduced stricter controls on uninstalled connected apps. The authenticating user must have the Approve Uninstalled Connected Apps (or Use Any API Client) system permission to authorize Starbridge for the first time. After a successful OAuth, the app appears under Connected Apps OAuth Usage where you can manage policies and assign it to additional users. See the instructions above under Choose who will connect your CRM > Step-by-step instructions for Salesforce.
5

Configure objects and fields

After connecting, open your CRM integration and click Objects & fields.
Screenshot 2026 06 08 At 4 03 08 PM
Use the CRM Configuration Guide panel on the right to review field recommendations by use case. For each use case you want to enable, click Enable all recommended fields — Starbridge selects the recommended objects and fields in one click.
Enable all the use cases you expect to need before saving. Each save triggers a resync, which can take a few minutes or a few hours depending on the amount of data being synced — selecting everything upfront means one resync instead of several as you add use cases over time.
Review the selected fields, adjust if needed, then click Save changes. Starbridge will only access, edit, or create data within the objects and fields you explicitly select here.
Starbridge will never modify or overwrite data in your CRM without your explicit approval. This step does not modify or overwrite any data in your CRM; it only connects your CRM to Starbridge so Starbridge can access its data moving forward.
6

Run the initial sync

You’ll see a Syncing status while the sync runs — duration depends on the size of your CRM. When complete, the status updates to Synced.

​
Next steps

With your CRM connected, the next step is account matching — mapping your CRM accounts to Starbridge buyers. This is required before territories, CRM-synced buyer lists, and lookup and sync columns will work.

Account matching

Map your CRM accounts to Starbridge buyers.