Optionalallow_Optionalallow_Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance.
Optionalallows_Pass True, if the poll allows multiple answers, defaults to False
Optionalallows_Pass True, if the poll allows to change chosen answer options, defaults to False for quizzes and to True for regular polls
Optionalbusiness_Unique identifier of the business connection on behalf of which the message will be sent
Unique identifier for the target chat or username of the target bot, supergroup or channel in the format @username. Polls can't be sent to channel direct messages chats.
Optionalclose_Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 2628000 seconds in the future. Can't be used together with open_period.
Optionalcorrect_A JSON-serialized list of monotonically increasing 0-based identifiers of the correct answer options, required for polls in quiz mode
Optionalcountry_A JSON-serialized list of 0-12 two-letter ISO 3166-1 alpha-2 country codes indicating the countries from which users can vote in the poll; for channel chats only. If omitted or empty, then users from any country can participate in the poll.
OptionaldescriptionDescription of the poll to be sent, 0-1024 characters after entities parsing
Optionaldescription_A JSON-serialized list of special entities that appear in the poll description, which can be specified instead of description_parse_mode
Optionaldescription_Mode for parsing entities in the poll description. See formatting options for more details.
Optionaldisable_Sends the message silently. Users will receive a notification with no sound.
OptionalexplanationText that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing
Optionalexplanation_A JSON-serialized list of special entities that appear in the poll explanation. It can be specified instead of explanation_parse_mode
Optionalexplanation_Media added to the quiz explanation
Optionalexplanation_Mode for parsing entities in the explanation. See formatting options for more details.
Optionalhide_Pass True, if poll results must be shown only after the poll closes
Optionalis_True, if the poll needs to be anonymous, defaults to True
Optionalis_Pass True if the poll needs to be immediately closed. This can be useful for poll preview.
OptionalmediaMedia added to the poll description
Optionalmembers_Pass True, if voting is limited to users who have been members of the chat where the poll is being sent for more than 24 hours; for channel chats only
Optionalmessage_Unique identifier of the message effect to be added to the message; for private chats only
Optionalmessage_Unique identifier for the target message thread (topic) of a forum; for forum supergroups and private chats of bots with forum topic mode enabled only
Optionalopen_Amount of time in seconds the poll will be active after creation, 5-2628000. Can't be used together with close_date.
A JSON-serialized list of 1-12 answer options
Optionalprotect_Protects the contents of the sent message from forwarding and saving
Poll question, 1-300 characters
Optionalquestion_A JSON-serialized list of special entities that appear in the poll question. It can be specified instead of question_parse_mode
Optionalquestion_Mode for parsing entities in the question. See formatting options for more details. Currently, only custom emoji entities are allowed
Optionalreply_Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user
Optionalreply_Description of the message to reply to
Optionalshuffle_Pass True, if the poll options must be shown in random order
OptionaltypePoll type, "quiz" or "regular", defaults to "regular"
Pass True, if answer options can be added to the poll after creation; not supported for anonymous polls and quizzes