Sync Partners from Salesforce

If your partner companies already exist in Salesforce, you don’t have to re-enter them into Fours — pick which Salesforce accounts count as partners and they’ll appear automatically in Partner Discovery, take each partner’s Partner Manager from its Account owner, and optionally sync their documents into your file library.


Overview

Once Salesforce is connected, you can tell Fours which of your Salesforce accounts are partners. Fours uses a filter you define to match those accounts and surface them under Partners → Partner Discovery → From Your CRM. You can also set each partner’s Partner Manager, and optionally its Partner Champion, from its linked Salesforce Account, write each partner’s tier back to that Account, and turn on Document Sync to pull files from your partner records into your Fours file library.

The CRM tab holds one card per setting: Partner discovery, Partner Manager from Salesforce, Partner tier to Salesforce, and Document sync. Each card starts collapsed: click its title to open it. The last three show in their header whether they’re On or Off, and each card saves only its own fields with its own Save.

Set Up Your Partner Mapping

Step 1: Access your partner settings

  1. Go to Fours Console, then Partners.
  2. Click Settings at the bottom of the rail, then CRM.
  3. Click Partner discovery to open its card.

Partner CRM settings under Fours Console Settings

Step 2: Choose the object that stores your partners

Under Object type, select the Salesforce object where your partner companies are stored.

Selecting the Salesforce object type that stores partners

Step 3: Set the filter that identifies a partner

Most teams mark partner accounts using an existing Salesforce field rather than a dedicated “is this a partner” checkbox. This step tells Fours which field and value to look for, so it knows which accounts are partners and which are regular customers.

Configuring the filter field and value that identifies a partner

  1. Under Filter field, select the field your team uses to mark an account as a partner — for example, the Account object’s Type field.
  2. Under Filter value (equals), select or enter the value that field holds on partner records.

What this field looks like depends on how it’s set up in your Salesforce org:

  • If it’s a picklist (a fixed dropdown of options), Fours shows you the same dropdown, so you just select the matching value — for example Partner — with no risk of a typo.
  • If it’s a free-text field, you’ll need to type the value manually, and it must exactly match what’s stored on the record. Confirm the correct spelling and case with whoever manages your Salesforce data.

Step 4: Map the name and email fields

  1. Under Name field, select the field that holds the partner’s company name.
  2. Under Email field, select the field that stores the email address you want Fours to use when inviting the partner. Depending on your Salesforce setup, this may be an Account field or a custom field.

Mapping the partner name and email fields

Step 5: Test and save

  1. Click Test configuration. Fours shows how many accounts match and a sample of the results.
  2. Check the Sample matches table to confirm company names and emails look correct.
  3. Click Save at the bottom of the Partner discovery card.

Step 6: Check where matched partners show up

After you save the configuration, matching accounts appear under Partners → Partner Discovery → From Your CRM. See Partner Discovery to learn more about Partner Discovery.

Matched partners appearing under Partner Discovery From Your CRM

Set the Partner Manager from Salesforce

If your team keeps each partner’s owner in Salesforce, Fours can take the Partner Manager from there instead of you picking it by hand on every partner record, and, optionally, the Partner Champion too. Both matter for co-sell: the Partner Manager leads your side of every co-sell you share with the partner, and the champion receives it. See Work a Partner Record.

  1. On the same CRM tab, open Partner Manager from Salesforce and switch on Sync from Salesforce.
  2. Under Account owner field, pick the user lookup on Account that names each partner’s owner. It starts on the Account’s own owner field, OwnerId, which is what most organizations use.
  3. Optionally, under Partner Champion field, pick a contact lookup on Account whose contact should become the partner’s champion. Leave it on Not synced to keep picking champions by hand.
  4. Click Save. Fours starts syncing your Salesforce-linked partners right away.

What the sync covers. Your ACTIVE partners that are linked to a Salesforce Account; a partner linked to a HubSpot company is left alone. It runs every two hours, when you save the mapping, and whenever you link a partner to a Salesforce Account, so a new link shows its Partner Manager straight away. This sync never writes the Partner Manager or the champion back to Salesforce.

The Account’s owner…The partner’s Partner Manager
Is a user in your Fours organizationBecomes that user.
Is on your organization’s email domain but isn’t a user yetIs left empty. The partner record says so and offers Add to organization; once the owner is added, they become the Partner Manager.
Is on another email domainIs left empty, because the owner can’t join your organization. Change the owner in Salesforce.
Isn’t set on the AccountStays as it was, and you can still change it by hand.

Salesforce decides while it has a value. As long as the Account names an owner, the partner record’s Partner Manager is read-only and changes only when the owner changes in Salesforce. The same goes for the Partner Champion when you’ve mapped a champion field and the Account names a contact in it. Link a partner to a different Account, or remove the link, and whatever the previous Account set is dropped; people you picked by hand stay.

Write Partner Tiers to Salesforce

Fours can write each partner’s tier to its linked Salesforce Account, so your sales team sees it where they work. This is the one setting on this tab that writes to Salesforce.

  1. On the CRM tab, open Partner tier to Salesforce.
  2. Switch on Write tiers to Salesforce. Fours reads your Account’s fields from Salesforce.
  3. Under Tier field, pick the Account field that gets the tier’s name: a text or picklist field Fours can write.
  4. Optionally, under Date the tier changed, pick a date/time field on Account. It gets the date and time the tier changed. Leave it empty to write no date.
  5. Click Save. Fours confirms “Partner tier mapping saved”.

Saving with sync on and no tier field is refused (“Pick the Account field the tier is written to”), and so is a field the Account doesn’t have. With sync on, a partner’s tier change is written to its linked Account straight away, and a nightly check corrects any Account whose tier differs from Fours. Only partners linked to a Salesforce Account are written. Partners → Settings → Tiers shows whether this is on, with a link back here.

Set Up Automatic Document Sync

Document Sync adds files from your Salesforce partner records into your Fours file library automatically.

  1. Open the Document sync card and switch on Sync documents.
  2. Under File types, choose which file types to sync (PDF, PPTX, DOCX, XLSX, and others). Leave this empty to sync every supported type.
  3. Under Name contains, optionally enter text to only sync files whose name includes it — for example, Agreement to pull in only agreement-related documents. Leave this blank to skip this filter.
  4. Click Save to save your settings.
  5. Click Sync now to immediately trigger a sync. Until document sync is switched on and saved, it reads “Turn document sync on and save it first.”

Document Sync settings with file type and name filters

Once files sync, they appear in Partners → Partner Files, alongside any manually uploaded files. Use the All Sources filter and select From Salesforce to view only synced files separately.

Spotted something wrong or out of date on this page? Tell us and we'll correct it.