A contact is a person/entity with whom you have communicated.

A contact has several handles to send messages to it. A handle has a source to identify which inbox can send message to this contact:

Source	Description	Example
email	An email address	calculon@pmomsbot.com
phone	A phone number	+123445678900
twitter	A twitter handle	calculon
facebook	A Facebook user ID
intercom	An Intercom user ID
smooch	A Smooch user ID
custom	Custom handle provided in the Recieve custom messages endpoint

Each pair handle/source is unique. If you want to move an existing handle from one contact to an other, you need to delete it from the first one and add it to the other one.

📘
Contact alias
You can use a contact source/handle pair as an alias for its ID. A contact ID alias follows the pattern alt:{source}:{handle}

Search Parameters

Contacts support search queries via parameter named q

Name	Type	Description
updated_before	number (optional)	Timestamp of the max date of the last update
updated_after	number (optional)	Timestamp of the min date of the last update

Example Contact Object

{
  "_links": {
    "self": "https://api2.frontapp.com/contacts/crd_55c8c149",
    "related": {
      "notes": "https://api2.frontapp.com/contacts/crd_55c8c149/notes",
      "conversations": "https://api2.frontapp.com/contacts/crd_55c8c149/conversations",
      "owner": "https://api2.frontapp.com/teams/tim_55c8c149"
    }
  },
  "id": "crd_55c8c149",
  "name": "Calculon",
  "description": "#vip #robot #RIP",
  "avatar_url": "http://example.com/calculon.jpg",
  "links": [
    "http://example.com"
  ],
  "handles": [
    {
      "handle": "@calculon",
      "source": "twitter"
    }
  ],
  "lists": [
    {
      "_links": {
        "self": "https://api2.frontapp.com/contacts/grp_55c8c149",
        "related": {
          "contacts": "https://api2.frontapp.com/contact_lists/grp_55c8c149/contacts",
          "owner": "https://api2.frontapp.com/teams/tim_55c8c149"
        }
      },
      "id": "grp_55c8c149",
      "name": "Customers",
      "is_private": false
    }
  ],
  "updated_at": 0,
  "custom_fields": {
    "job title": "engineer",
    "custom field name": "your value"
  },
  "is_private": false
}