Show the details of a contact
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Contact Attributes
| Attribute Name | Type | Description | Attributes |
|---|---|---|---|
self | reference | URL of the Contact | Read-only Non-null |
prefix | string | Salutation, e.g. "Mr." or "Dr." (max 128 characters) | Read-Write Nullable Searchable |
individual_salutation | string | How to address the contact in letters, e.g. "Dear John" (max 512 characters) | Read-Write Nullable |
first_name | string | First name (max 256 characters) | Read-Write Nullable Searchable |
middle_name | string | Middle name(s) (max 256 characters) | Read-Write Nullable Searchable |
last_name | string | Last name (max 256 characters) | Read-Write Nullable Searchable |
full_name | string | First, middle and last name joined with spaces | Read-only Nullable Searchable |
suffix | string | Name suffix, e.g. "Jr." or "PhD" (max 64 characters) | Read-Write Nullable Searchable |
alias | string | Legal alias (max 512 characters) | Read-Write Nullable Searchable |
nickname | string | Casual nickname (max 256 characters) | Read-Write Nullable Searchable |
birthday | date | Birthday, optionally without a year (see below) | Read-Write Nullable Searchable |
anniversary | date | Anniversary, optionally without a year (see below) | Read-Write Nullable Searchable |
flagged | boolean | Whether the contact is flagged | Read-Write Non-null Searchable |
tagline | string | Tagline (max 512 characters) | Read-Write Nullable Searchable |
hobbies | string | Hobbies (max 1024 characters) | Read-Write Nullable |
image | reference | URL of the Contact Image. Only present when the contact has an image | Read-only Nullable Searchable |
category | string | Category name | Read-Write Nullable Searchable |
keywords | array of string | List of Keywords (max 64) | Read-Write Nullable Searchable |
extra_fields | object | Extra (custom) field values, keyed by field identifier. See Extra Fields | Read-Write Nullable Searchable |
emails | array of email | List of Email addresses. Searched as email_addresses | Read-Write Nullable Searchable |
urls | array of url | List of URLs | Read-Write Nullable Searchable |
social_profiles | array of social_profile | List of Social Profiles | Read-Write Nullable Searchable |
phone_numbers | array of phone_number | List of Phone Numbers | Read-Write Nullable Searchable |
addresses | array of address | List of Addresses | Read-Write Nullable Searchable |
details | string | Short notes about the contact (max 8000 characters) | Read-Write Nullable |
companies | array of company roles | Companies the contact works for, with company, title, department, role and default | Read-Write Nullable Searchable |
opportunities | array of opportunity roles | Opportunities the contact is involved in, with opportunity, title and role | Read-Write Nullable Searchable |
projects | array of project roles | Projects the contact is involved in, with project, title and role | Read-Write Nullable Searchable |
contacts | array of relationship | Related contacts, with contact, relationship_type and direction. See Relationships | Read-Write Nullable |
appointments | array of link | Linked Appointments | Read-Write Nullable Searchable |
groups | array of link | Linked Groups | Read-Write Nullable Searchable |
notes | array of link | Linked Notes | Read-Write Nullable Searchable |
tasks | array of link | Linked Tasks | Read-Write Nullable Searchable |
forms | array of link | Linked Forms | Read-Write Nullable Searchable |
user | reference | The User whose own contact record this is. Only present for users' contacts | Read-only Nullable Searchable |
owner | reference | URL of the User responsible for the contact | Read-Write Non-null Default value is the user making the request Searchable |
creator | reference | URL of the User that created the contact | Read-only Non-null Searchable |
trashed | boolean | Whether the contact is in the trash. Set to false to restore it | Read-only Non-null |
create_date | datetime | When the contact was created | Read-only Non-null Searchable |
modify_date | datetime | When the contact was last updated | Read-only Non-null Searchable |
Aliases and NicknamesIn many regions,
aliasrefers to an alternative legal name that can be used on legal documents in place of a persons original name.On the other hand, nicknames are a casual alternative name with no legal weight.
Birthdays and AnniversariesBirthdays and anniversaries are special because some people prefer to keep the year secret, or they've forgotten, or perhaps for some other reason it is unimportant. In these cases, in order to maintain ISO8601 compatibility, we will use
0000as the year to indicate that the year component is actually missing.An example birthday on June 3rd, for an unknown year, would be serialized as
0000-06-03. Send dates in the sameYYYY-MM-DDformat; sendnullto clear them.
Extra Fields
extra_fields holds the values of the contact's custom fields. Contacts have 12 text fields and 4 date fields. Each is keyed by its default identifier, even if the field has been renamed in Daylite, and only fields with a value are returned:
"extra_fields": {
"com.marketcircle.daylite/extra1": { "value": "Gold", "display_name": "Membership" },
"com.marketcircle.daylite/extra_date_1": { "value": "2025-03-07T18:00:04.000Z", "display_name": "Renewal Date" }
}display_name is the field's current name and is read-only. When creating or updating a contact, send only the value. Fields you leave out keep their current value, and sending null or {} clears all of them.
Contact DetailsThe
detailsattribute is meant for short notes or details about a contact that don't fit into any other attribute. The field length is limited to 8000 characters.Longer notes should be added as a Note and linked to the contact.