A person is an individual human being, and is the most basic unit of data in folk.

​
Person fields

Every person has pre-defined fields shared by every people. We call them native fields.
  • firstName: The first name of the person.
  • lastName: The last name of the person.
  • fullName: The full name of the person. Usually generated from the first and last name.
  • description: A short description of the person.
  • birthday: The birthday of the person.
  • emails: A list of email addresses of the person.
  • phones: A list of phone numbers of the person.
  • addresses: A list of addresses of the person.
  • urls: A list of URLs of the person.
  • companies: A list of companies associated with the person.
  • groups: A list of groups associated with the person.
The first value in the list of emails, phones, addresses, urls and companies fields is the primary value. Primary values are used to display the most relevant information about the person in the app, and are used as the default value for the field in some operations. For instance, when sending a campaign to a person, the primary email address will be used to send the email.
You can also add custom fields to people, which are additional attributes that can be defined in each group. Read more about custom fields in the Custom fields section.

​
Person relationships

​
Companies

People can be associated with one or more companies through the companies relationship. The first company in the list is the person’s primary company. A person can be associated with multiple companies, but they will only appear in the primary company’s details.

Companies

Read more about companies

​
Groups

People can be organized into one or more groups through the groups relationship.

Groups

Read more about groups