Actions43
- Chat Actions
- Add Chat Members
- Close Chat
- Close Chat (Lite)
- Create SuperGroup or Channel
- Delete Chat
- Get Chat
- Get Chat History
- Get Chats
- Join Chat
- Mark Chat as Unread
- Open Chat
- Open Chat (Lite)
- Search Public Chat (by Username, Lite)
- Search Public Chat (by Username)
- Search Public Chats (Search in Username, Title)
- Send Chat Action
- Contact Actions
- Custom Request Actions
- File Actions
- Group Actions
- Login Actions
- Message Actions
- User Actions
User → Create New Secret Chat
AI-generatedSummary
Create a new secret Telegram chat with a specified user
Inputs
- user_id (required) — ID of the user to start a secret chat with
Output shape
object
The operation returns the TDLib response object representing the newly created secret chat; a single item is emitted on success.
Examples
Example 1: Start a secret chat
Operation: Create New Secret Chat, Resource: User, User ID: 123456789
Example 2: Create secret chat then send a message
Operation: Create New Secret Chat, User ID: 987654321, followed by Send Message using the returned chat ID
Example 3: Create secret chat with force (treated as private chat option)
Operation: Create New Secret Chat, User ID: 11223344, Force: true (optional for private chats, not required for secret chats)