{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"People","projectTitle":"Frontline Documentation","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"people","__idx":0},"children":["People"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["people"]}," object stores individual contacts. It is extensible but cannot be deleted."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"standard-fields","__idx":1},"children":["Standard fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Behavior"},"children":["Behavior"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only title composed from First Name and Last Name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["First Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Editable component of Name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Last Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Editable component of Name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (email)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique and the primary deduplication key."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phone Number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (phone_number)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Secondary deduplication key."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (text)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Postal address."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Role"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Job title or role."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Website"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (url)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact website."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Linkedin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (url)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LinkedIn profile."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Location"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact location."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Language"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preferred language."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Relationship Type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["select"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lead, Customer, Churned, Vendor, Partner, Investor, or Other."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Users"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["prismaRelation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Assigned Frontline account users."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Last Interaction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only timestamp maintained from recent interactions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Company"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["relation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Single relation to a record in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companies"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["frontline object schema people"]}," to inspect the current account schema, including custom fields and select options."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"deduplication-and-identification","__idx":2},"children":["Deduplication and identification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["People are deduplicated by email first and phone number second. Uniqueness applies across the entire object, including all record types."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"automatic-company-linking","__idx":3},"children":["Automatic Company linking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a Person is created or updated with an email on a non-generic business domain, Frontline can:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find an existing Company whose ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Domain"]}," matches the email domain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Link the Person to that Company."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create and enrich the Company when no match exists."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"channel-and-profile-behavior","__idx":4},"children":["Channel and profile behavior"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["People can be created automatically from email, WhatsApp, Instagram, Messenger, and agent conversations according to the account's contact creation settings."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Communication activity is attached to the Person timeline. Frontline also maintains profile context such as summaries, memories, relationship insights, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Last Interaction"]},"; do not duplicate these with custom fields or parallel activity tables."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example","__idx":5},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"frontline object record create people --data '{\n  \"First Name\": \"Jane\",\n  \"Last Name\": \"Doe\",\n  \"Email\": \"jane@example.com\"\n}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/standard-objects/companies"},"children":["Companies"]}," for Company-side linking and activity behavior."]}]},"headings":[{"value":"People","id":"people","depth":1},{"value":"Standard fields","id":"standard-fields","depth":2},{"value":"Deduplication and identification","id":"deduplication-and-identification","depth":2},{"value":"Automatic Company linking","id":"automatic-company-linking","depth":2},{"value":"Channel and profile behavior","id":"channel-and-profile-behavior","depth":2},{"value":"Example","id":"example","depth":2}],"frontmatter":{"seo":{"title":"People"}},"lastModified":"2026-07-30T19:19:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/standard-objects/people","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}