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

Delete a note

Request

You can delete a single contact or company note. Notes of other kinds cannot be deleted through the API.

Security
bearerAuth
Path
idintegerrequired

The unique identifier of a given note

Example:1
Headers
Intercom-Versionstring(intercom_version_preview)

Preview Intercom API version. Used for closed beta endpoints or other features under managed availability.

Default:"Preview"
Value:"Preview"
Example:Preview
curl -i -X DELETE \
  https://api.intercom.io/notes/1 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

Responses

successful

Bodyapplication/json
idstring

The unique identifier for the note which you provided in the URL.

Example:"34"
typestring

The type of object which was deleted. - note

Value:"note"
Example:"note"
deletedboolean

Whether the note was deleted successfully or not.

Example:true
Response
{
  "id": "34",
  "type": "note",
  "deleted": true
}