Find duplicate contact - Automate.ax

highlevel.findDuplicateContact finds an existing contact by email or phone before creation.

automations/highlevel-find-duplicate-contact.automation.ts

import { automation, markSignificant } from "automate.ax"
import { highlevel } from "automate.ax/highlevel"

export default automation("Find duplicate contact", () => {
  markSignificant(highlevel.findDuplicateContact({ email: "ada@example.com" }))
})

Input

Field	Type	Required	Description
`number`	`string`	No	HighLevel number value.
`email`	`string`	No	HighLevel email value.

Automate.ax supplies the connected sub-account’s location ID. Optional second argument { account } selects a named HighLevel binding.

Output

Returns HighLevel’s duplicate-contact result, including the matching contact when one exists. This action calls GET /contacts/search/duplicate with HighLevel API version 2021-07-28 and requires contacts.readonly. HighLevel validation and permission errors fail the action. Rate limits honor the provider’s retry timing.