ContactShipInstall

Summary

Identify a visitor's session by linking an existing anonymous session ID to a known contact, optionally creating the contact if it does not exist in ContactShip. This operation syncs events associated with the session to the identified contact within about a minute and requires the Events add-on.

Inputs

• Session ID (required) — The session ID previously used with anonymous events (e.g., Google Analytics client ID), up to 200 characters without spaces.
• Contact (required) — At least one identifier of the contact to associate with the session, including Contact ID, External ID, Phone, or Email. Additional contact fields like Name and Country can be provided for contact creation.
• Options — Settings including whether to create the contact automatically if no match is found (default true).

Output shape

No direct output data but triggers attribute linkage in ContactShip to associate session events with the identified contact; effects are asynchronous with events attached within about a minute.

Requires the ContactShip Events add-on to function. If contact creation is disabled and no contact matches, session remains unlinked. Input validation requires at least one contact identifier field.

Examples

Example 1: Link anonymous session data to a known customer after login using their email, creating a new contact if needed.

Set Session ID to the anonymous session value, provide the customer's email in Contact, and keep 'Create Contact' option enabled.

Links

• n8n community nodes installation guide