1. Contacts
  2. Model

Contacts

Model

Contact Model

The Contact model represents a contact entity with various attributes and associated names, addresses, emails, phones, and metadata.


Attributes

object "contact"
The description of the model.

id string
Unique identifier for the contact.

organization_id string
Unique identifier for the organization that owns this contact. This will always be your organization ID.

name string
The name of the contact.

nickname string
The nickname of the contact.

email string
The email for the contact.

id_number string
The id number for the contact.

phone string
The phone number for this contact.

groups Array.<{id:string; name:string; location_id:string}>
A list of groups IDs to which this contact is associated.

locations Array.<{name:string; id:string}>
A list of location IDs to which this contact is associated.

notes string
Any notes that were added about this contact.

created_at integer
Time in epoch seconds when this resource was created.

updated_at integer
Time in epoch seconds when this contact was last updated.

updated_by string
The ID of the user or key who last updated the contact.

metadata object
Additional Key value pairs associated with the contact.

checksum string
The checksum of the contact object.

alternate_names object

Show Details
alternate_names.0 string
Alternate name 1, which is also the nickname
alternate_names.1 string
Alternate name 2
alternate_names.2 string
Alternate name 3
alternate_names.3 string
Alternate name 4
alternate_names.4 string
Alternate name 5

address Address
The parsed address for this contact.

alternate_addresses object

Show Details
alternate_addresses.secondary string
The first alternate address, which is also the secondary address
alternate_addresses.secondary_line2 string
Line2 for the first alternate address
alternate_addresses.home string
alternate_addresses.home_line2 string
alternate_addresses.work string
alternate_addresses.work_line2 string
alternate_addresses.education string
alternate_addresses.education_line2 string
alternate_addresses.other string
alternate_addresses.other_line string

alternate_emails object

Show Details
alternate_emails.personal string
Alternate personal email
alternate_emails.education string
Alternate education email
alternate_emails.work string
Alternate work email
alternate_emails.social string
Alternate social email
alternate_emails.other string
Alternate other email

alternate_phones object

Show Details
alternate_phones.mobile string
Alternate mobile phone
alternate_phones.education string
Alternate education phone
alternate_phones.work string
Alternate work phone
alternate_phones.home string
Alternate home phone
alternate_phones.other string
Alternate other phone

_search object
A special property that will be included if searching through contacts. This is a flat object which will include <mark> tags around characters that have matched the search. You can use this to more easily highlight text for a user interface.

Show Details
_search.id string
The ID of the contact.
_search.type string
The type of contact.
_search.name string
The contact's name. It will also match common nicknames.
_search.email string
The contact's email.
_search.phone string
The contact's phone.
_search.formatted_address string
The contact's full address string.
_search.relevance_score ?number
A number from 0 - 1 about how relevant the result was to the search query, with 1 being a perfect match.

options object
The options passed into the request.

Show Details
options.parse_addresses Boolean
If the addresses should be parsed when the scan is created
options.match_contacts Boolean
If the sender and recipient fields should be matched to an existing contact