Skip to content
Last updated

The people object stores individual contacts. It is extensible but cannot be deleted.

Standard fields

FieldTypeBehavior
NamestringRead-only title composed from First Name and Last Name.
First NamestringEditable component of Name.
Last NamestringEditable component of Name.
Emailstring (email)Unique and the primary deduplication key.
Phone Numberstring (phone_number)Secondary deduplication key.
Addressstring (text)Postal address.
RolestringJob title or role.
Websitestring (url)Contact website.
Linkedinstring (url)LinkedIn profile.
LocationstringContact location.
LanguagestringPreferred language.
Relationship TypeselectLead, Customer, Churned, Vendor, Partner, Investor, or Other.
UsersprismaRelationAssigned Frontline account users.
Last InteractiondateRead-only timestamp maintained from recent interactions.
CompanyrelationSingle relation to a record in companies.

Use frontline object schema people to inspect the current account schema, including custom fields and select options.

Deduplication and identification

People are deduplicated by email first and phone number second. Uniqueness applies across the entire object, including all record types.

People created from channels may initially be anonymous. Normal People list and search operations return identified contacts only. A contact is identified when sufficient information such as a name, email, or phone number is available.

Automatic Company linking

When a Person is created or updated with an email on a non-generic business domain, Frontline can:

  1. Find an existing Company whose Domain matches the email domain.
  2. Link the Person to that Company.
  3. Create and enrich the Company when no match exists.

Generic email domains such as Gmail or Outlook are not auto-linked. Contacts without an email also require a manual Company relation when one is needed.

Channel and profile behavior

People can be created automatically from email, WhatsApp, Instagram, Messenger, and agent conversations according to the account's contact creation settings.

Communication activity is attached to the Person timeline. Frontline also maintains profile context such as summaries, memories, relationship insights, and Last Interaction; do not duplicate these with custom fields or parallel activity tables.

Example

frontline object record create people --data '{
  "First Name": "Jane",
  "Last Name": "Doe",
  "Email": "jane@example.com"
}'

See Companies for Company-side linking and activity behavior.