> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altahq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Person

> The person object represents a contact in your account.

A person is an individual contact with profile and location information. Persons can be enrolled in campaigns as [prospects](/api-reference/objects/prospect).

## Fields

<ParamField path="id" type="string (uuid)" required>
  Unique identifier for the person.
</ParamField>

<ParamField path="objectType" type="string" required>
  Always `person`.
</ParamField>

<ParamField path="firstName" type="string | null">
  The person's first name.
</ParamField>

<ParamField path="lastName" type="string | null">
  The person's last name.
</ParamField>

<ParamField path="email" type="string | null">
  The person's email address.
</ParamField>

<ParamField path="title" type="string | null">
  The person's job title.
</ParamField>

<ParamField path="linkedinUrl" type="string | null">
  URL to the person's LinkedIn profile.
</ParamField>

<ParamField path="photoUrl" type="string | null">
  URL to the person's photo.
</ParamField>

<ParamField path="city" type="string | null">
  The city where the person is located.
</ParamField>

<ParamField path="state" type="string | null">
  The state or region where the person is located.
</ParamField>

<ParamField path="country" type="string | null">
  The country where the person is located.
</ParamField>

<ParamField path="createdAt" type="string (date-time)" required>
  Timestamp when the person was created.
</ParamField>

<ParamField path="updatedAt" type="string (date-time)" required>
  Timestamp when the person was last updated.
</ParamField>

## Example

```json theme={null}
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "objectType": "person",
  "firstName": "Jane",
  "lastName": "Smith",
  "email": "jane.smith@acme.com",
  "title": "VP of Engineering",
  "linkedinUrl": "https://linkedin.com/in/janesmith",
  "photoUrl": "https://example.com/photos/jane.jpg",
  "city": "San Francisco",
  "state": "California",
  "country": "United States",
  "createdAt": "2024-01-05T12:00:00Z",
  "updatedAt": "2024-01-20T16:45:00Z"
}
```

## Used in

* [List persons](/api-reference/persons/list) - returns an array of person objects
* [Get a person](/api-reference/persons/get) - returns a single person object