channels.createChannel
channels.createChannel
Section titled “channels.createChannel”No description provided by the pinned schema.
Signature
Section titled “Signature”channels.createChannel#91006707 flags:# broadcast:flags.0?true megagroup:flags.1?true for_import:flags.3?true forum:flags.5?true title:string about:string geo_point:flags.2?InputGeoPoint address:flags.2?string ttl_period:flags.4?int = Updates;Result type
Section titled “Result type”Updates
Parameters
Section titled “Parameters”| Name | Type | Flag | Default | Description |
|---|---|---|---|---|
| flags | # | flag word | — | No description provided by the pinned schema. |
| broadcast | flags.0?true | flags.0 | — | No description provided by the pinned schema. |
| megagroup | flags.1?true | flags.1 | — | No description provided by the pinned schema. |
| for_import | flags.3?true | flags.3 | — | No description provided by the pinned schema. |
| forum | flags.5?true | flags.5 | — | No description provided by the pinned schema. |
| title | string | — | — | No description provided by the pinned schema. |
| about | string | — | — | No description provided by the pinned schema. |
| geo_point | flags.2?InputGeoPoint | flags.2 | — | No description provided by the pinned schema. |
| address | flags.2?string | flags.2 | — | No description provided by the pinned schema. |
| ttl_period | flags.4?int | flags.4 | — | No description provided by the pinned schema. |
| Parameter | Bit | Meaning |
|---|---|---|
| broadcast | 0 | Controlled by flags; present when this bit is set. |
| megagroup | 1 | Controlled by flags; present when this bit is set. |
| for_import | 3 | Controlled by flags; present when this bit is set. |
| forum | 5 | Controlled by flags; present when this bit is set. |
| geo_point | 2 | Controlled by flags; present when this bit is set. |
| address | 2 | Controlled by flags; present when this bit is set. |
| ttl_period | 4 | Controlled by flags; present when this bit is set. |
Python binding
Section titled “Python binding”from miniproto.raw.functions import ChannelsCreateChannelPublic access: miniproto.raw.functions.ChannelsCreateChannel.
Safe usage shape
Section titled “Safe usage shape”from miniproto.raw.functions import ChannelsCreateChannel
# Naming the raw request class is local only; it performs no I/O or network request.request_type = ChannelsCreateChannelResult family
Section titled “Result family”RPC errors
Section titled “RPC errors”| Code | Error | Description |
|---|---|---|
| 400 | ADDRESS_INVALID | The specified geopoint address is invalid. |
| 400 | BUSINESS_CONNECTION_NOT_ALLOWED | This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we’re a user, and users cannot invoke methods over a business connection; (2) we’re a bot, but business mode was disabled in @botfather or (3); we’re a bot, but this method cannot be invoked over a business connection. |
| 400 | CHANNELS_ADMIN_LOCATED_TOO_MUCH | The user has reached the limit of public geogroups. |
| 400 | CHANNELS_TOO_MUCH | You have joined too many channels/supergroups. |
| 400 | CHAT_ABOUT_TOO_LONG | Chat about too long. |
| 400 | CHAT_TITLE_EMPTY | No chat title provided. |
| 400 | TTL_PERIOD_INVALID | The specified TTL period is invalid. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
| 403 | USER_RESTRICTED | You’re spamreported, you can’t create channels or chats. |
| 406 | USER_RESTRICTED | You’re spamreported, you can’t create channels or chats. |
| 420 | ADDRESS_INVALID | The specified geopoint address is invalid. |
| 500 | CHAT_INVALID | Invalid chat. |
Accepted types
Section titled “Accepted types”InputGeoPoint
Known selected constructors: inputGeoPoint, inputGeoPointEmpty
Returned types
Section titled “Returned types”Updates
Known selected constructors: updateShort, updateShortChatMessage, updateShortMessage, updateShortSentMessage, updates, updatesCombined, updatesTooLong
Related methods
Section titled “Related methods”account.getBotBusinessConnection, account.getNotifyExceptions, account.toggleWebBrowserSettingsException, account.updateBusinessLocation, account.updateConnectedBot, bots.allowSendMessage, channels.convertToGigagroup, channels.deleteChannel, channels.deleteHistory, channels.editAdmin, channels.editBanned, channels.editLocation, channels.editPhoto, channels.editTitle, channels.leaveChannel, channels.restrictSponsoredMessages, channels.setBoostsToUnblockRestrictions, channels.toggleAntiSpam, channels.toggleAutotranslation, channels.toggleForum, channels.toggleJoinRequest, channels.toggleJoinToSend, channels.toggleParticipantsHidden, channels.togglePreHistoryHidden, channels.toggleSignatures, channels.toggleSlowMode, channels.toggleViewForumAsMessages, channels.updateColor, channels.updateEmojiStatus, channels.updatePaidMessagesPrice, chatlists.joinChatlistInvite, chatlists.joinChatlistUpdates, chatlists.leaveChatlist, communities.create, communities.toggleCommunityCollapsedInDialogs, contacts.acceptContact, contacts.addContact, contacts.blockFromReplies, contacts.deleteContacts, contacts.getLocated, ephemeral.editMessage, ephemeral.sendMessage, folders.editPeerFolders, messages.addPollAnswer, messages.appendTodoList, messages.createForumTopic, messages.deleteChatUser, messages.deleteFactCheck, messages.deleteParticipantReaction, messages.deletePollAnswer, messages.deleteQuickReplyMessages, messages.deleteScheduledMessages, messages.editChatCreator, messages.editChatDefaultBannedRights, messages.editChatParticipantRank, messages.editChatPhoto, messages.editChatTitle, messages.editFactCheck, messages.editForumTopic, messages.editMessage, messages.forwardMessages, messages.getAllDrafts, messages.getExtendedMedia, messages.getInlineBotResults, messages.getMessagesReactions, messages.getPaidReactionPrivacy, messages.getPollResults, messages.hideAllChatJoinRequests, messages.hideChatJoinRequest, messages.migrateChat, messages.reorderPinnedForumTopics, messages.sendBotRequestedPeer, messages.sendInlineBotResult, messages.sendMedia, messages.sendMessage, messages.sendMultiMedia, messages.sendPaidReaction, messages.sendQuickReplyMessages, messages.sendReaction, messages.sendScheduledMessages, messages.sendScreenshotNotification, messages.sendVote, messages.sendWebViewData, messages.setChatAvailableReactions, messages.setChatTheme, messages.setChatWallPaper, messages.setGameScore, messages.setHistoryTTL, messages.startBot, messages.toggleNoForwards, messages.toggleSuggestedPostApproval, messages.toggleTodoCompleted, messages.updatePinnedForumTopic, messages.updatePinnedMessage, payments.applyGiftCode, payments.assignAppStoreTransaction, payments.assignPlayMarketTransaction, payments.craftStarGift, payments.launchPrepaidGiveaway, payments.refundStarsCharge, payments.resolveStarGiftOffer, payments.sendStarGiftOffer, payments.transferStarGift, payments.updateStarGiftPrice, payments.upgradeStarGift, phone.createConferenceCall, phone.createGroupCall, phone.declineConferenceCallInvite, phone.deleteConferenceCallParticipants, phone.deleteGroupCallMessages, phone.deleteGroupCallParticipantMessages, phone.discardCall, phone.discardGroupCall, phone.editGroupCallParticipant, phone.editGroupCallTitle, phone.getGroupCallChainBlocks, phone.inviteConferenceCallParticipant, phone.inviteToGroupCall, phone.joinGroupCall, phone.joinGroupCallPresentation, phone.leaveGroupCall, phone.leaveGroupCallPresentation, phone.sendConferenceCallBroadcast, phone.sendGroupCallMessage, phone.setCallRating, phone.startScheduledGroupCall, phone.toggleGroupCallRecord, phone.toggleGroupCallSettings, phone.toggleGroupCallStartSubscription, stories.activateStealthMode, stories.editStory, stories.getAllReadPeerStories, stories.sendReaction, stories.sendStory, stories.startLive, users.suggestBirthday
Availability evidence
Section titled “Availability evidence”- user only
Provenance
Section titled “Provenance”- layer: 228
- structural source:
tdlib - canonical schema: https://raw.githubusercontent.com/tdlib/td/refs/heads/master/td/generate/scheme/telegram_api.tl
- prose merge precedence: TDLib → Telegram Desktop → Core JSON
- source note: Canonical structure is the pinned TDLib telegram_api.tl; Layer 228 comes only from the matching Telegram Desktop end-of-file marker; core.telegram.org inputs enrich documentation and RPC error metadata without overriding structure.
Source-diff notes
Section titled “Source-diff notes”- tdlib_vs_core: changed_count=68; core_only_count=1; overlap_count=2302; tdlib_only_count=158
- tdlib_vs_tdesktop: changed_count=0; overlap_count=2448; tdesktop_only=null; tdlib_only=accessPointRule, ephemeral.editMessage, help.configSimple, inputPeerPhotoFileLocationLegacy, inputStickerSetThumbLegacy, invokeWithApnsSecretPrefix, invokeWithBusinessConnectionPrefix, invokeWithGooglePlayIntegrityPrefix, invokeWithReCaptchaPrefix, ipPort, ipPortSecret, updateEphemeralBotCallbackQuery
miniprotoFast paths where they count. Explicit boundaries everywhere else.