Documentation

Link responses to contacts

Choose whether a response is saved alone, joins a contact you have, or creates a new one.

A response can stand alone, or belong to a contact in Analytics. You choose per Journey.

Choose the rule

Open the Journey tab of the panel on the right, find Responses, and set Contact for a response. Save the Journey first: the setting is available once it exists.

ChoiceWhat happensUse it for
No contactEach response is saved by itselfAn anonymous survey or quiz
A contact you haveThe response joins a matching contact. No new contact is made.Asking your existing customers
A contact, new if neededThe response joins a matching contact. With no match, a new contact is made.Lead capture and onboarding. New Journeys start with this.

A Journey never changes a contact you already have.

How a person is matched

FounderHQ matches by email, phone, or your own user ID, within the brand.

From the answers

FounderHQ reads these from the Journey's Input fields:

It findsIn
An emailA field of type Email, or one whose answer name contains email
A phone numberA field of type Phone, or one whose answer name contains phone
Your user IDA field whose answer name is externalid

So a Journey with an email field links its responses with no more work.

From your app

When the Journey runs inside your product, your app already knows who the person is. Pass that to the SDK and FounderHQ uses it instead of what the person typed. See Embed on the web and Mobile.

A Journey opened by public link or iframe has no app around it, so it matches from the answers only.

What you see on a response

Open Journeys → Responses. Each completed response has a contact status.

StatusMeaning
LinkedJoined a contact you had
CreatedMade a new contact
Not LinkedNo match, and the rule did not allow a new contact
Not RequestedThe Journey is set to No contact
Contact ConflictMore than one contact matched, so FounderHQ linked none

Verify

  1. Complete the Journey with an email address you can recognize.
  2. Open Journeys → Responses. The response shows Created or Linked.
  3. Open the contact in Analytics → People. Their Journeys tab lists the Journey.

AI agent or LLM? Read this page as markdown

On this page