Skip to content
Home/
REST API Reference
/
/
Retrieve a note

Retrieve a note

Request

You can fetch the details of a single note.

Security
bearerAuth
Path
idstringrequired

The unique identifier of a given note

Example:34
Headers
Intercom-Versionstring(intercom_version)

Intercom API version.
If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"
Example:Preview
curl -i -X GET \
  https://api.intercom.io/notes/34 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

Responses

Note found

Bodyapplication/json
typestring

String representing the object's type. Always has the value note.

Example:"note"
idstring

The id of the note.

Example:"17495962"
created_atinteger, (timestamp)

The time the note was created.

Example:1674589321
contactobject or null

Represents the contact that the note was created about.

companyobject or null

Represents the company that the note was created about.

authorobject or null(Admin)

Represents the Admin that created the note. When the note has no recorded admin, this is null on a single note and left out of each note in a list.

bodystring

The body text of the note.

Example:"<p>Text for the note.</p>"
Response
{
  "type": "note",
  "id": "34",
  "created_at": 1733846617,
  "contact": {
    "type": "contact",
    "id": "6762f2591bb69f9f2193bc1f"
  },
  "author": {
    "type": "admin",
    "id": "991267864",
    "name": "Ciaran346 Lee",
    "email": "admin346@email.com",
    "away_mode_enabled": false,
    "away_mode_reassign": false
  },
  "body": "<p>This is a note.</p>"
}