Reference
folder.created — Folder created
A chat folder appeared on the account (made in the app, on the phone or in another Telegram app). Carries the folder's title, filters and how many chats it lists — never which chats.
View MarkdownThis page is generated from the source code on every release.
A chat folder appeared on the account (made in the app, on the phone or in another Telegram app). Carries the folder's title, filters and how many chats it lists — never which chats.
Since web 2.1.0, worker —.
| Name | Value |
|---|---|
| Code | folder.created |
| Group | Chat folders |
| Status | Subscribable |
| Scope needed to receive it | messages.read |
| Tied to one account | Yes |
| Only the connection that caused it receives it | No |
| Filters that apply | — |
Fields dropped in thin content mode |
folder.title |
| Fields written by outside people (untrusted) | folder.title |
JSON Schema
https://tlg.builera.app/schemas/events/folder.created/2.json
Sample payload (exactly what webhooks.test sends)
{
"specversion": "1.0",
"id": "evt_01JDOCSSAMPLE",
"source": "https://tlg.builera.app/ws/07c2e5e1-c42f-4212-851b-c55b6dd7989d",
"type": "folder.created",
"time": "2026-10-21T13:45:00.123Z",
"datacontenttype": "application/json",
"dataschema": "https://tlg.builera.app/schemas/events/folder.created/2.json",
"platform": "telegram",
"workspaceid": "07c2e5e1-c42f-4212-851b-c55b6dd7989d",
"accountid": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
"seq": "000000000000000",
"schemaversion": "2",
"correlationid": null,
"causationid": null,
"test": true,
"replay": false,
"data": {
"account": {
"id": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
"label": "Sale 1",
"username": "sale_demo_1",
"tg_user_id": "100200300"
},
"folder": {
"id": "2c4e6a8b-0d1f-4a3c-9e5b-7d9f1b3d5f7a",
"tg_folder_id": 3,
"kind": "filter",
"title": "Khách mới",
"emoticon": "⭐",
"color": 2,
"position": 0,
"filters": {
"contacts": false,
"non_contacts": true,
"groups": false,
"broadcasts": false,
"bots": false,
"exclude_muted": true,
"exclude_read": false,
"exclude_archived": true
},
"chats": {
"pinned": 1,
"included": 4,
"excluded": 0
}
},
"untrusted_fields": [
"folder.title"
]
}
}