All docs

Duplicates and merging for your own objects

Choose which fields tell two records apart, review the groups Formspring finds, merge them field by field, and undo a merge.

Updated . 5 min read.

The same project, property or person can end up in your CRM twice, from an import and a hand-typed entry. Formspring can group records that look like the same thing so you can combine them. Nothing merges on its own. The screen works for your own objects and for contacts, companies, deals and tasks; for contacts and companies it uses the same finder and merge as Duplicates and merging.

Choose the rules

  1. Open Settings, then Data model, and choose the object.
  2. Under Finding duplicates, tick the fields that tell two records apart, such as an email address, a phone number or a name.
  3. Choose Save rules.

Two records are grouped when they share a value in any ticked field. Capital letters and padding are ignored, phone numbers are compared by their digits, and every address in an emails or phones field counts. A group can link several records: if A matches B and B matches C, all three are shown together. A rule that needs several fields to agree at once (the first and last name, for example) can be set through the API.

Contacts, companies, deals and tasks

  • Contacts are grouped on their email and user ID, and on their phone number when you tick it. Only a one-way key of an email or phone is compared, so the values stay private. The extra emails and phone numbers of a contact count too: a contact whose second address is another contact's address (or only differs by a +tag, or the dots of a Gmail address) lands in the same group, and groups chain (A shares with B, B shares with C). The group says what it matched on. A merge is the contact merge, with its Undo. By default the contact you keep keeps what it has and fills in what it lacks. To settle fields one by one, choose Merge field by field: for every field where the two differ, pick the value you keep, including the Owner and Lifecycle stage. Picking the other contact's empty value clears yours, and Undo puts every value back. Fields you cannot read or change are never chosen or filled from the other contact, and you need the right to delete the contact you merge away.
  • Companies are grouped on their name and domain (and any field you tick). The company you keep takes the other's people, deals, tasks, notes and history, and fills in the details it lacks, your own fields and their files included. For the Domain, Size, Industry and your own fields you can instead pick, field by field, whether the company you keep or the other one wins. The other company is kept out of sight until the undo window closes, so the merge can be undone.
  • Deals are grouped on title and contact, tasks on title and due date, and you can tick other built-in or custom fields. A merge keeps the first record, fills what it lacks from the other, moves notes, tasks and links, and removes the other. It can be undone: the removed deal or task comes back as it was, with the files it held. Those files are kept until the undo window closes and then removed.

Merging these needs the same right as editing them on their own pages.

Review and merge

Choose Find duplicates on the object's page. For each group:

  1. Choose Merge.
  2. Pick the record to keep and the one to merge into it.
  3. For every field where they differ, choose which value stays. Where the kept record has no value, it takes the other's.
  4. Confirm.

The merge runs in the background. The kept record also takes over the other's notes, tasks, history and links (a link the kept record already has is not doubled, and where a field can hold only one linked record, the kept record's stays). The other record is removed.

Recent merges and undo

Recent merges lists every merge of the object, for contacts, companies, deals, tasks and your own objects: which record went into which, who merged them and when, the values the kept record took from the other, how much moved to it (notes, tasks, history, links, people, deals) and where the undo stands: open until a date, undone on a date, or no longer possible.

Choose Undo on a merge to take it back. Everything that moved goes back and the other record is restored with its id, values, history and links. You have 14 days. A merge cannot be undone if the kept record has been changed since (its changes would be lost), or if another record now uses a unique value the merged one had. You are told which. After the 14 days the merge keeps its facts (who, when, which fields, how much moved) and lets go of the copy only an undo needed.

Automations and webhooks

A merge announces crm_record.merged about the record that stays, with the id of the one folded into it. See automation triggers.