Create contact - Automate.ax

highlevel.createContact creates a contact in the connected sub-account.

automations/highlevel-create-contact.automation.ts

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

export default automation("Create contact", () => {
  markSignificant(highlevel.createContact({}))
})

Input

Field	Type	Required	Description
`firstName`	`string \| null`	No	HighLevel first name value.
`lastName`	`string \| null`	No	HighLevel last name value.
`name`	`string \| null`	No	HighLevel name value.
`email`	`string \| null`	No	HighLevel email value.
`gender`	`string`	No	HighLevel gender value.
`phone`	`string \| null`	No	HighLevel phone value.
`address1`	`string \| null`	No	HighLevel address1 value.
`city`	`string \| null`	No	HighLevel city value.
`state`	`string \| null`	No	HighLevel state value.
`postalCode`	`string`	No	HighLevel postal code value.
`website`	`string \| null`	No	HighLevel website value.
`timezone`	`string \| null`	No	HighLevel timezone value.
`dnd`	`boolean`	No	HighLevel Do Not Disturb setting.
`dndSettings`	`object`	No	HighLevel Do Not Disturb settings.
`inboundDndSettings`	`object`	No	HighLevel inbound Do Not Disturb settings.
`tags`	`string[]`	No	HighLevel tags value.
`customFields`	`object[]`	No	HighLevel custom fields value.
`source`	`string`	No	HighLevel source value.
`dateOfBirth`	`string \| null`	No	Birth date in a HighLevel-supported date format such as `YYYY-MM-DD`.
`country`	`string`	No	HighLevel country value.
`companyName`	`string \| null`	No	HighLevel company name value.
`assignedTo`	`string`	No	User’s Id

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

Output

Field	Type	Required	Description
`contact`	`object`	No	HighLevel contact value.

This action calls POST /contacts/ with HighLevel API version 2021-07-28 and requires contacts.write. HighLevel validation and permission errors fail the action. Rate limits honor the provider’s retry timing. Automate.ax does not automatically replay this create or send operation after an indeterminate transport failure.