Skip to main content

​
Overview

Webhook events for FolderNoteRelation resources. These events track the relationship between folders and notes. All FolderNote events use resourceType: "FolderNoteRelation".

​
Event Details

Resource ID pattern: folder_{folderId}:note_{noteGuid}

​
folder.note.added

  • Triggered when a note is added to a folder

​
folder.note.removed

  • Triggered when a note is removed from a folder

​
Example Payloads

​
folder.note.added

{
  "id": "evt_01J9ABCDEF",
  "type": "folder.note.added",
  "createdAt": "2025-09-05T07:12:34Z",
  "data": {
    "resourceType": "FolderNoteRelation",
    "resourceId": "folder_123:note_IA8BgAct0ZkBk",
    "resource": {
      "folder": {
        "id": "123",
        "title": "Project Meeting",
        "isTeamFolder": true
      },
      "noteGuid": "IA8BgAct0ZkBk"
    }
  }
}

​
folder.note.removed

{
  "id": "evt_01J9ABCDEF",
  "type": "folder.note.removed",
  "createdAt": "2025-09-05T07:12:34Z",
  "data": {
    "resourceType": "FolderNoteRelation",
    "resourceId": "folder_123:note_IA8BgAct0ZkBk",
    "resource": {
      "folder": {
        "id": "123",
        "title": "Project Meeting",
        "isTeamFolder": true
      },
      "noteGuid": "IA8BgAct0ZkBk"
    }
  }
}

​
Resource Data Structure

​
FolderNoteRelationExternalEventData

​
folder
object
required
Folder information
​
folder.id
string
required
Folder ID (as string)
​
folder.title
string
required
Folder title
​
folder.isTeamFolder
boolean
required
Whether this is a team folder (true if teamNoteSharingType is not null)
​
noteGuid
string
required
GUID of the added note

​
Resource ID Structure

Resource ID uses a composite structure that can identify both folder and note: 
folder_{folderId}:note_{noteGuid}
Examples:
  • folder_123:note_IA8BgAct0ZkBk
  • folder_456:note_oKqMhoYTHlPrt2
This structure allows clear identification of which note was added to which folder. Related events that may be added in the future:

Event Structure

Standard webhook event format

Note Events

Note-related event documentation

Best Practices

Guidelines for handling webhook events

Webhooks Overview

General webhook information and setup