Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
aiogram 3.20.0.post0 documentation
Logo
aiogram 3.20.0.post0 documentation
  • Installation
  • Migration FAQ (2.x -> 3.0)
  • Bot API
    • Bot
    • Client session
      • Use Custom API server
      • Base
      • aiohttp
      • Client session middlewares
    • Types
      • AcceptedGiftTypes
      • Animation
      • Audio
      • BackgroundFill
      • BackgroundFillFreeformGradient
      • BackgroundFillGradient
      • BackgroundFillSolid
      • BackgroundType
      • BackgroundTypeChatTheme
      • BackgroundTypeFill
      • BackgroundTypePattern
      • BackgroundTypeWallpaper
      • Birthdate
      • BotCommand
      • BotCommandScope
      • BotCommandScopeAllChatAdministrators
      • BotCommandScopeAllGroupChats
      • BotCommandScopeAllPrivateChats
      • BotCommandScopeChat
      • BotCommandScopeChatAdministrators
      • BotCommandScopeChatMember
      • BotCommandScopeDefault
      • BotDescription
      • BotName
      • BotShortDescription
      • BusinessBotRights
      • BusinessConnection
      • BusinessIntro
      • BusinessLocation
      • BusinessMessagesDeleted
      • BusinessOpeningHours
      • BusinessOpeningHoursInterval
      • CallbackQuery
      • Chat
      • ChatAdministratorRights
      • ChatBackground
      • ChatBoost
      • ChatBoostAdded
      • ChatBoostRemoved
      • ChatBoostSource
      • ChatBoostSourceGiftCode
      • ChatBoostSourceGiveaway
      • ChatBoostSourcePremium
      • ChatBoostUpdated
      • ChatFullInfo
      • ChatInviteLink
      • ChatJoinRequest
      • ChatLocation
      • ChatMember
      • ChatMemberAdministrator
      • ChatMemberBanned
      • ChatMemberLeft
      • ChatMemberMember
      • ChatMemberOwner
      • ChatMemberRestricted
      • ChatMemberUpdated
      • ChatPermissions
      • ChatPhoto
      • ChatShared
      • Contact
      • CopyTextButton
      • Dice
      • Document
      • ExternalReplyInfo
      • File
      • ForceReply
      • ForumTopic
      • ForumTopicClosed
      • ForumTopicCreated
      • ForumTopicEdited
      • ForumTopicReopened
      • GeneralForumTopicHidden
      • GeneralForumTopicUnhidden
      • Gift
      • GiftInfo
      • Gifts
      • Giveaway
      • GiveawayCompleted
      • GiveawayCreated
      • GiveawayWinners
      • InaccessibleMessage
      • InlineKeyboardButton
      • InlineKeyboardMarkup
      • InputFile
      • InputMedia
      • InputMediaAnimation
      • InputMediaAudio
      • InputMediaDocument
      • InputMediaPhoto
      • InputMediaVideo
      • InputPaidMedia
      • InputPaidMediaPhoto
      • InputPaidMediaVideo
      • InputPollOption
      • InputProfilePhoto
      • InputProfilePhotoAnimated
      • InputProfilePhotoStatic
      • InputStoryContent
      • InputStoryContentPhoto
      • InputStoryContentVideo
      • KeyboardButton
      • KeyboardButtonPollType
      • KeyboardButtonRequestChat
      • KeyboardButtonRequestUser
      • KeyboardButtonRequestUsers
      • LinkPreviewOptions
      • Location
      • LocationAddress
      • LoginUrl
      • MaybeInaccessibleMessage
      • MenuButton
      • MenuButtonCommands
      • MenuButtonDefault
      • MenuButtonWebApp
      • Message
      • MessageAutoDeleteTimerChanged
      • MessageEntity
      • MessageId
      • MessageOrigin
      • MessageOriginChannel
      • MessageOriginChat
      • MessageOriginHiddenUser
      • MessageOriginUser
      • MessageReactionCountUpdated
      • MessageReactionUpdated
      • OwnedGift
      • OwnedGiftRegular
      • OwnedGiftUnique
      • OwnedGifts
      • PaidMedia
      • PaidMediaInfo
      • PaidMediaPhoto
      • PaidMediaPreview
      • PaidMediaVideo
      • PaidMessagePriceChanged
      • PhotoSize
      • Poll
      • PollAnswer
      • PollOption
      • ProximityAlertTriggered
      • ReactionCount
      • ReactionType
      • ReactionTypeCustomEmoji
      • ReactionTypeEmoji
      • ReactionTypePaid
      • ReplyKeyboardMarkup
      • ReplyKeyboardRemove
      • ReplyParameters
      • ResponseParameters
      • SharedUser
      • StarAmount
      • Story
      • StoryArea
      • StoryAreaPosition
      • StoryAreaType
      • StoryAreaTypeLink
      • StoryAreaTypeLocation
      • StoryAreaTypeSuggestedReaction
      • StoryAreaTypeUniqueGift
      • StoryAreaTypeWeather
      • SwitchInlineQueryChosenChat
      • TextQuote
      • UniqueGift
      • UniqueGiftBackdrop
      • UniqueGiftBackdropColors
      • UniqueGiftInfo
      • UniqueGiftModel
      • UniqueGiftSymbol
      • User
      • UserChatBoosts
      • UserProfilePhotos
      • UserShared
      • UsersShared
      • Venue
      • Video
      • VideoChatEnded
      • VideoChatParticipantsInvited
      • VideoChatScheduled
      • VideoChatStarted
      • VideoNote
      • Voice
      • WebAppData
      • WebAppInfo
      • WriteAccessAllowed
      • ChosenInlineResult
      • InlineQuery
      • InlineQueryResult
      • InlineQueryResultArticle
      • InlineQueryResultAudio
      • InlineQueryResultCachedAudio
      • InlineQueryResultCachedDocument
      • InlineQueryResultCachedGif
      • InlineQueryResultCachedMpeg4Gif
      • InlineQueryResultCachedPhoto
      • InlineQueryResultCachedSticker
      • InlineQueryResultCachedVideo
      • InlineQueryResultCachedVoice
      • InlineQueryResultContact
      • InlineQueryResultDocument
      • InlineQueryResultGame
      • InlineQueryResultGif
      • InlineQueryResultLocation
      • InlineQueryResultMpeg4Gif
      • InlineQueryResultPhoto
      • InlineQueryResultVenue
      • InlineQueryResultVideo
      • InlineQueryResultVoice
      • InlineQueryResultsButton
      • InputContactMessageContent
      • InputInvoiceMessageContent
      • InputLocationMessageContent
      • InputMessageContent
      • InputTextMessageContent
      • InputVenueMessageContent
      • PreparedInlineMessage
      • SentWebAppMessage
      • AffiliateInfo
      • Invoice
      • LabeledPrice
      • OrderInfo
      • PaidMediaPurchased
      • PreCheckoutQuery
      • RefundedPayment
      • RevenueWithdrawalState
      • RevenueWithdrawalStateFailed
      • RevenueWithdrawalStatePending
      • RevenueWithdrawalStateSucceeded
      • ShippingAddress
      • ShippingOption
      • ShippingQuery
      • StarTransaction
      • StarTransactions
      • SuccessfulPayment
      • TransactionPartner
      • TransactionPartnerAffiliateProgram
      • TransactionPartnerChat
      • TransactionPartnerFragment
      • TransactionPartnerOther
      • TransactionPartnerTelegramAds
      • TransactionPartnerTelegramApi
      • TransactionPartnerUser
      • InputSticker
      • MaskPosition
      • Sticker
      • StickerSet
      • EncryptedCredentials
      • EncryptedPassportElement
      • PassportData
      • PassportElementError
      • PassportElementErrorDataField
      • PassportElementErrorFile
      • PassportElementErrorFiles
      • PassportElementErrorFrontSide
      • PassportElementErrorReverseSide
      • PassportElementErrorSelfie
      • PassportElementErrorTranslationFile
      • PassportElementErrorTranslationFiles
      • PassportElementErrorUnspecified
      • PassportFile
      • Update
      • WebhookInfo
      • CallbackGame
      • Game
      • GameHighScore
    • Methods
      • addStickerToSet
      • createNewStickerSet
      • deleteStickerFromSet
      • deleteStickerSet
      • getCustomEmojiStickers
      • getStickerSet
      • replaceStickerInSet
      • sendSticker
      • setCustomEmojiStickerSetThumbnail
      • setStickerEmojiList
      • setStickerKeywords
      • setStickerMaskPosition
      • setStickerPositionInSet
      • setStickerSetThumbnail
      • setStickerSetTitle
      • uploadStickerFile
      • answerCallbackQuery
      • approveChatJoinRequest
      • banChatMember
      • banChatSenderChat
      • close
      • closeForumTopic
      • closeGeneralForumTopic
      • copyMessage
      • copyMessages
      • createChatInviteLink
      • createChatSubscriptionInviteLink
      • createForumTopic
      • declineChatJoinRequest
      • deleteChatPhoto
      • deleteChatStickerSet
      • deleteForumTopic
      • deleteMyCommands
      • editChatInviteLink
      • editChatSubscriptionInviteLink
      • editForumTopic
      • editGeneralForumTopic
      • exportChatInviteLink
      • forwardMessage
      • forwardMessages
      • getBusinessConnection
      • getChat
      • getChatAdministrators
      • getChatMember
      • getChatMemberCount
      • getChatMenuButton
      • getFile
      • getForumTopicIconStickers
      • getMe
      • getMyCommands
      • getMyDefaultAdministratorRights
      • getMyDescription
      • getMyName
      • getMyShortDescription
      • getUserChatBoosts
      • getUserProfilePhotos
      • hideGeneralForumTopic
      • leaveChat
      • logOut
      • pinChatMessage
      • promoteChatMember
      • reopenForumTopic
      • reopenGeneralForumTopic
      • restrictChatMember
      • revokeChatInviteLink
      • sendAnimation
      • sendAudio
      • sendChatAction
      • sendContact
      • sendDice
      • sendDocument
      • sendLocation
      • sendMediaGroup
      • sendMessage
      • sendPaidMedia
      • sendPhoto
      • sendPoll
      • sendVenue
      • sendVideo
      • sendVideoNote
      • sendVoice
      • setChatAdministratorCustomTitle
      • setChatDescription
      • setChatMenuButton
      • setChatPermissions
      • setChatPhoto
      • setChatStickerSet
      • setChatTitle
      • setMessageReaction
      • setMyCommands
      • setMyDefaultAdministratorRights
      • setMyDescription
      • setMyName
      • setMyShortDescription
      • setUserEmojiStatus
      • unbanChatMember
      • unbanChatSenderChat
      • unhideGeneralForumTopic
      • unpinAllChatMessages
      • unpinAllForumTopicMessages
      • unpinAllGeneralForumTopicMessages
      • unpinChatMessage
      • convertGiftToStars
      • deleteBusinessMessages
      • deleteMessage
      • deleteMessages
      • deleteStory
      • editMessageCaption
      • editMessageLiveLocation
      • editMessageMedia
      • editMessageReplyMarkup
      • editMessageText
      • editStory
      • getAvailableGifts
      • getBusinessAccountGifts
      • getBusinessAccountStarBalance
      • giftPremiumSubscription
      • postStory
      • readBusinessMessage
      • removeBusinessAccountProfilePhoto
      • removeChatVerification
      • removeUserVerification
      • sendGift
      • setBusinessAccountBio
      • setBusinessAccountGiftSettings
      • setBusinessAccountName
      • setBusinessAccountProfilePhoto
      • setBusinessAccountUsername
      • stopMessageLiveLocation
      • stopPoll
      • transferBusinessAccountStars
      • transferGift
      • upgradeGift
      • verifyChat
      • verifyUser
      • answerInlineQuery
      • answerWebAppQuery
      • savePreparedInlineMessage
      • getGameHighScores
      • sendGame
      • setGameScore
      • answerPreCheckoutQuery
      • answerShippingQuery
      • createInvoiceLink
      • editUserStarSubscription
      • getStarTransactions
      • refundStarPayment
      • sendInvoice
      • deleteWebhook
      • getUpdates
      • getWebhookInfo
      • setWebhook
      • setPassportDataErrors
    • Enums
      • BotCommandScopeType
      • ChatAction
      • ChatBoostSourceType
      • ChatMemberStatus
      • ChatType
      • ContentType
      • Currency
      • DiceEmoji
      • EncryptedPassportElement
      • InlineQueryResultType
      • InputMediaType
      • InputPaidMediaType
      • InputProfilePhotoType
      • InputStoryContentType
      • KeyboardButtonPollTypeType
      • MaskPositionPoint
      • MenuButtonType
      • MessageEntityType
      • MessageOriginType
      • OwnedGiftType
      • PaidMediaType
      • ParseMode
      • PassportElementErrorType
      • PollType
      • ReactionTypeType
      • RevenueWithdrawalStateType
      • StickerFormat
      • StickerType
      • StoryAreaTypeType
      • TopicIconColor
      • TransactionPartnerType
      • TransactionPartnerUserTransactionTypeEnum
      • UpdateType
    • How to download file?
    • How to upload file?
    • Global defaults
  • Handling events
    • Router
    • Dispatcher
    • Dependency injection
    • Filtering events
      • Command
      • ChatMemberUpdated
      • Magic filters
      • MagicData
      • Callback Data Factory & Filter
      • Exceptions
    • Long-polling
    • Finite State Machine
      • Storages
      • Strategy
      • Scenes Wizard
    • Middlewares
    • Errors
    • Flags
    • Webhook
    • Class based handlers
      • BaseHandler
      • CallbackQueryHandler
      • ChosenInlineResultHandler
      • ErrorHandler
      • InlineQueryHandler
      • MessageHandler
      • PollHandler
      • PreCheckoutQueryHandler
      • ShippingQueryHandler
      • ChatMemberHandler
  • Utils
    • Keyboard builder
    • Translation
    • Chat action sender
    • WebApp
    • Callback answer
    • Formatting
    • Media group builder
    • Deep Linking
    • Telegram object serialization
  • Changelog
  • Contributing
Back to top
View this page

exportChatInviteLink¶

Returns: str

class aiogram.methods.export_chat_invite_link.ExportChatInviteLink(*, chat_id: int | str, **extra_data: Any)[source]¶

Use this method to generate a new primary invite link for a chat; any previously generated primary link is revoked. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the new invite link as String on success.

Note: Each administrator in a chat generates their own invite links. Bots can’t use invite links generated by other administrators. If you want your bot to work with invite links, it will need to generate its own link using aiogram.methods.export_chat_invite_link.ExportChatInviteLink or by calling the aiogram.methods.get_chat.GetChat method. If your bot needs to generate a new primary invite link replacing its previous one, use aiogram.methods.export_chat_invite_link.ExportChatInviteLink again.

Source: https://core.telegram.org/bots/api#exportchatinvitelink

chat_id: ChatIdUnion¶

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

Usage¶

As bot method¶

result: str = await bot.export_chat_invite_link(...)

Method as object¶

Imports:

  • from aiogram.methods.export_chat_invite_link import ExportChatInviteLink

  • alias: from aiogram.methods import ExportChatInviteLink

With specific bot¶

result: str = await bot(ExportChatInviteLink(...))

As reply into Webhook in handler¶

return ExportChatInviteLink(...)

As shortcut from received object¶

  • aiogram.types.chat.Chat.export_invite_link()

Next
forwardMessage
Previous
editGeneralForumTopic
Copyright © 2025, aiogram Team
Made with Sphinx and @pradyunsg's Furo
On this page
  • exportChatInviteLink
    • ExportChatInviteLink
      • ExportChatInviteLink.chat_id
    • Usage
      • As bot method
      • Method as object
        • With specific bot
        • As reply into Webhook in handler
      • As shortcut from received object