BoomerangInstall

Summary

Creates a new contact in the specified location, supporting optional name splitting and custom fields.

Inputs

• locationId (required) — The sub-account/location to operate on. Loaded from your agency credential.
• email — Contact email — used for matching existing contacts on upsert. Only shown for upsert/update/create operations.
• name — Full name. Boomerang does NOT parse this into first/last — so when First Name and Last Name are both empty, this node splits it (first word to First Name, the rest to Last Name) before sending. An explicit First Name or Last Name always takes priority and suppresses the split. Only shown for upsert/update/create operations.
• firstName — Only shown for upsert/update/create operations.
• lastName — Only shown for upsert/update/create operations.
• address1 — Only shown for upsert/update/create operations.
• city — Only shown for upsert/update/create operations.
• state — Only shown for upsert/update/create operations.
• postalCode — Only shown for upsert/update/create operations.
• country — 2-letter ISO country code (e.g., US, CA, GB). Only shown for upsert/update/create operations.
• phone — Phone number with country code. Only shown for upsert/update/create operations.
• source — Lead source (e.g., "Webrunner - Google Paid", "Referral"). Only shown for upsert/update/create operations.
• customFieldsMapper — All contact custom fields for the selected location. Hit the refresh icon after changing location. Only shown for upsert/update/create operations.

Output shape

a single record

Returns the bare (unwrapped) contact object. If using 'upsert' or 'update', the node expects at least one of email or phone to perform the match/deduplicate step; sending neither causes an HTTP 400.

Examples

Example 1: Create a new contact with a full name and email

Set locationId, email, and name. The node will auto-split the name into firstName/lastName if First Name and Last Name are empty.

Example 2: Create a contact with custom fields

Select a location and use the Custom Fields mapper to populate location-specific attributes.

Links

• n8n community nodes installation guide