Skip to content
  • There are no suggestions because the search field is empty.

What are 2-way sync CRM agents and how to create a CRM agent

Learn how to set up a CRM agent to pull your CRM records into Firmable, enrich them with accurate data, and use them to find net-new prospects.

A CRM agent manages the connection between your CRM and Firmable. Each agent pulls a defined set of records from your CRM on a schedule you control.

Prerequisites

Before setting up 2-way CRM sync, ensure the following:

  • You are an Admin on your Firmable account.
  • You have an active HubSpot or Salesforce account.
  • You are on a Teams Pro or Enterprise plan on Firmable.

What is a CRM agent?

CRM agents are most commonly used for three things:

  • Finding net-new prospects: pull your existing CRM records into Firmable so searches automatically exclude them. Every result is a genuinely new prospect.
  • Enriching records in bulk: identify contacts or companies with missing data, such as no mobile number, and enrich them at scale without manual exports.
  • Re-engaging CRM segments: build an agent around a specific segment, such as closed-lost accounts, and monitor those records for buying signals.

What you can do with a CRM agent

The CRM Agents page lists what an agent lets you do with the records it pulls from your CRM:

  • Keep data refreshed: re-enrich the agent's records with Firmable data, either manually or on a weekly or monthly schedule (see Step 4 below).
  • Exclude from searches: leave records that are already in your CRM out of your search results, so you only see net-new companies and people (see Filtering search results by CRM data below).
  • Track signals: monitor the agent's records for buying signals, for example to re-engage closed-lost accounts.
  • Find contact details: fill in missing details, such as mobile numbers, for the records the agent pulls.
  • View and segment: browse the agent's records in its CRM list under Lists, and filter Search by them.
  • Export records: export the agent's records from Firmable.

The CRM Agents page with the What you can do options highlighted

Before you start

For accurate matching and deduplication over time, we recommend creating the following custom property in your CRM before setting up your first agent.

Firmable ID

Create a single-line text field with a length of 20 characters. Company IDs are a lowercase "f" followed by 12 digits (for example, f000001729377), and person IDs are "fp" followed by 12 digits, so a 20-character field fits both. Set it as a unique identifier. Firmable ID is permanent and does not change even if a contact changes company, email address, or phone number. Mapping it early gives you the most reliable matching key for the life of the record.

Setting up a CRM agent

Step 1: Connect your CRM

  • Click your profile picture (top right) and select Manage account.
  • Select Integrations in the Account settings sidebar.
  • Select HubSpot or Salesforce as your CRM platform.
  • Follow the prompts to authorise the connection.
  • Click your connected CRM to open the setup page.
    HubSpot connected on the Integrations page
  • Turn on data pull for your CRM. For HubSpot, toggle on Allow CRM agent to pull companies and contacts from HubSpot into Firmable Allow CRM agent to pull toggle highlighted

Step 2: Select record type

  • Click CRM Agents in the top navigation.
    CRM Agents in the top navigation highlighted
  • Click Create.
    The CRM Agents page with the Create button highlighted
  • Under Select record type to pull, choose what to import from your CRM:

    • Companies (HubSpot) or Accounts (Salesforce)
    • Contacts (HubSpot and Salesforce)
    • Leads (Salesforce only)

    Record type options highlighted
  • Click Continue.
    The Create CRM agent page with Companies selected as the record type and the Continue button highlighted

Step 3: Configure filtering rules

Choose how Firmable determines which records to pull:

  • All records: Every record of the selected type will be pulled from your CRM.
  • Based on condition: Define AND/OR logic to filter which records are pulled (for example, only records owned by a specific team, or records within a certain industry).
    Based on condition filter highlighted

Step 4: Set enrichment schedule

We recommend starting with manual enrichment first. This allows you to confirm that records are matching correctly and that CRM sync is working as expected. Automatic enrichment on a schedule can consume a large batch of credits before anyone notices, so only move to it once you're confident in the results and understand how credits are being used.

Choose how often Firmable re-enriches the records in this agent:

  • Manual: Enrichment only runs when you trigger it.
    The Set CRM enrichment rules step with the Manual option highlighted
  • Scheduled: Records are automatically re-enriched each week or month.
    Scheduled enrichment and frequency highlighted
  • Click Continue.

Step 5: Name and save the agent

  • Give the agent a name that reflects the records it contains (for example, "HubSpot ANZ Accounts").
    Agent title field highlighted
  • Click Create agent to save.
    The Agent title step with a name entered and the Create agent button highlighted
  • Confirm that the agent and its records appear in Firmable under the name you assigned.

Viewing your CRM agent

Once an agent is created, click CRM Agents in the top navigation, then select the agent in the left-hand panel. From the agent view:

  • See a summary of records matched and enriched, credits used and the enrichment schedule.
    A CRM agent view with the summary of matched and enriched records, credits used and enrichment schedule highlighted
  • View the full run history in the run log table.
    Enrichment history table highlighted
  • Click Enrich now to manually trigger a new run and confirm it appears in the log.
    A CRM agent view with the Enrich now button highlighted

Viewing CRM records in Firmable

  • Records pulled by a CRM agent appear in the Lists page under a dedicated CRM section.CRM lists tab and CRM agent list highlighted

  • CRM agent lists reflect the most up-to-date data from the last agent run.
  • These lists are read-only and cannot be manually modified.
  • To push records back to your CRM with enriched data, select records from the list and click Push to HubSpot or Push to Salesforce.
    Selected record and Push to HubSpot highlighted

Filtering search results by CRM data

CRM agent records can be used to filter results in Firmable's Search page:

  • Open the CRM agent records filter (under Company activity) and select a CRM agent to see only its records.
    The Search filters panel with the CRM agent records filter under Company activity highlighted
  • Hover over the CRM agent and click + to include its records, or the exclude icon to exclude them.
    Include icon on a CRM agent highlighted
  • Use the CRM record owner filter (also under Company activity) to focus on a team member's accounts or people records.
    The Search filters panel with the CRM record owner filter under Company activity highlighted
    Include icon on a record owner highlighted
    Exclude icon on a record owner highlighted

Records found through search can be selected and pushed to your CRM with enriched Firmable data.