API ReferenceBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreCommunityBlogYour Apps

The Note model

Example Note Object

{
  "type": "note",
  "id": "16",
  "created_at": 1389913941,
  "body": "<p>Text for my note</p>",
  "author": {
    "type": "admin",
    "id": "21",
    "name": "Jayne Cobb",
    "email": "[email protected]",
    "companies": []
  },
  "user": {
    "type": "user",
    "id": "5310d8e8598c9a0b24000005"
  }
}

Notes allow you to annotate and comment on your contacts.

📘

Companies and Conversations

Currently not possible to create notes for companies. Reach out if you want to submit a feature request, we take these into account.

Conversations notes are created via the Reply a conversations API.

Object Models

Note

FieldTypeDescription
typestringString representing the object's type. Always has the value note.
idstringThe id of the note.
created_atintegerThe time the note was created.
contactobjectRepresents the contact that the note was created about.
authorobjectAdmins are teammate accounts that have access to a workspace.
bodystringThe body text of the note.

Admin

FieldTypeDescription
typestringString representing the object's type. Always has the value admin.
idstringThe id representing the admin.
namestringThe name of the admin.
emailstringThe email of the admin.
job_titlestringThe job title of the admin.
away_mode_enabledbooleanIdentifies if this admin is currently set in away mode.
away_mode_reassignbooleanIdentifies if this admin is set to automatically reassign new conversations to the apps default inbox.
has_inbox_seatbooleanIdentifies if this admin has a paid inbox seat to restrict/allow features that require them.
team_idsarrayThis object represents the avatar associated with the admin.
avatarstringImage for the associated team or teammate
team_priority_levelobjectAdmin priority levels for teams