Applicable plans
Sprout Blossom Garden EstateForest

Freshsales allows users to associate multiple accounts with a contact. Here are some use-cases where this feature will be helpful - 

 

  1. In real estate business, a seller/property owner/broker (contact) can be associated to more than 1 property (account).

  2. In tourism business, a travel agent (contact) can be associated to more than one location/tourist attraction (account).

  3. A CEO (contact) of Company 1 (account) can be in board of directors on Company 2 (account) and thus can act as an influencer for your business in both companies.

 

How to add multiple accounts to contact?

  1. On create contact form, click on icon.

  2. Select to mark an account as primary. Job title field on contact is associated to the primary account

  3. To remove an account, click on associatedto remove any account.




How many accounts can be associated to a contact?

A maximum of 25 accounts can be associated to a contact. 


What is the impact of multiple accounts to contacts association on different features of Freshsales ?



Impact areas

Behaviour

Contact create

  • ‘Account name’ field is replaced with ‘Accounts’ field

  • User can add multiple accounts associated to contact. Max limit is 25.

  • Primary Account is mandatory if any account is associated to contact.

  • Accounts field behaviour remains the same. The choices show existing accounts present. A new account record is auto-created, if not present.

Contact update

  • Account name field is replaced with Accounts field

  • User can add/remove/update multiple accounts associated to contact.Max limit is 25.

  • Primary Account is mandatory if any account is associated to contact.

  • Accounts field behavior remains the same. The choices show existing accounts present. A new account record is auto-created, if not present.

Contact merge

  • Accounts field value of primary contact is appended with account of secondary contact.

  • Max 25 accounts can be associated. If more than 25 accounts are present, only 25 are retained and rest accounts association is lost.

Contact inline

  • In landing page, related accounts are available in header section. When you click on Primary Account edit, Accounts field is editable inline.

  • Same behaviour in list views. 

Contact import

  • Only Primary Account is imported. 

  • With Add new records option, primary account is associated to new contacts created

  • With Update without overwriting values, csv file does not impact contacts with accounts already present. If accounts are not present, contact Accounts field is updated as per csv file value

  • With Update with overwriting values, csv file account value is added as Primary Account and all existing accounts are appended as secondary accounts. Please note here existing primary account becomes secondary account and no value is lost.

Contact API

  •  Backward compatibility will be maintained for over a period of 6 months. We will deprecate the old APIs after this period. Backward compatibility includes below keys in JSON

    • sales_account_id

      • When sales_account_id key is passed, we will add the association and make it as primary

      • Example => “sales_account_id”: 1

    • sales_account

      • When sales_account key is passed, we will add the association and make the newly created sales account as the primary

      • Example => “sales_account”: {“name”: “Default Company”}

  • New key - sales_accounts can be used to associate Multiple Sales Accounts to a contact. Please note that only association will be possible, dynamic creation of multiple accounts is not supported. Value of new key can be sent as below

    • Example => “sales_accounts”: [{“id”: 1, “is_primary”: true}, {“id”: 2, “is_primary”: false}]

    • Here id will be sales account id 

    • is_primary can be sent to specify the primary sales account of the contact

    • Please note there should be at least one id whose is_primary key value is true.

    • Only valid sales account ids will be accepted

    • We will always replace older associations with the new ones if sales_accounts key is passed. Customer should pass sales_accounts as null or empty( [] ) if he wants to delete all existing associations.

  • Please note that precedence is maintained when all above keys are sent together 

    • sales_accounts > sales_account > sales_account_id

Contact bulk update

  • Bulk update overwrites the Accounts field values

Contact landing page

  • All related accounts are displayed on contact header section 

Contact list view filters

  • Filter on Accounts field works on all account values associated irrespective of primary or secondary

Lead convert

  • Company name of lead is appended as secondary account if the lead exists as contact (with same email address) with accounts associated

Account landing page

  • All related contacts are displayed

  • Conversations of all contacts are displayed under Accounts recent conversations

Account deleted

  • In contacts where the deleted account is primart, next account value in the Accounts list on contact is made primary

Workflow

  • Accounts filter can be applied and works on all accounts associated irrespective of primary or secondary

CRM Migration

  • Only primary account is considered

Module customization

  • Accounts field is accordingly renamed

Multiple language support

  • Accounts field is accordingly translated

Mobile

  • Only primary account value is displayed. Will provide support for multiple accounts soon