--- title: Create a poll --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Realtime Kit](https://developers.cloudflare.com/api/python/resources/realtime_kit) [Active Session](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/active-session) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create a poll realtime\_kit.active\_session.create\_poll(strmeeting\_id, ActiveSessionCreatePollParams\*\*kwargs) -> [ActiveSessionCreatePollResponse]() POST/accounts/{account\_id}/realtime/kit/{app\_id}/meetings/{meeting\_id}/active-session/poll Creates a new poll in an active session for the given meeting ID. ##### Security API Token The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/). **Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY` ##### Accepted Permissions (at least one required) `Realtime Admin``Realtime` ##### ParametersExpand Collapse account\_id: str The account identifier tag. maxLength32 [Link to this property](<#(resource)%20realtime_kit.active-session%20%3E%20(method)%20create_poll%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) app\_id: str The app identifier tag. [Link to this property](<#(resource)%20realtime_kit.active-session%20%3E%20(method)%20create_poll%20%3E%20(params)%20default%20%3E%20(param)%20app_id%20%3E%20(schema)>) meeting\_id: str [Link to this property](<#(resource)%20realtime_kit.active-session%20%3E%20(method)%20create_poll%20%3E%20(params)%20default%20%3E%20(param)%20meeting_id%20%3E%20(schema)>) options: Sequence\[str] Different options for the question [Link to this property](<#(resource)%20realtime_kit.active-session%20%3E%20(method)%20create_poll%20%3E%20(params)%20default%20%3E%20(param)%20options%20%3E%20(schema)>) question: str Question of the poll [Link to this property](<#(resource)%20realtime_kit.active-session%20%3E%20(method)%20create_poll%20%3E%20(params)%20default%20%3E%20(param)%20question%20%3E%20(schema)>) anonymous: Optional\[[bool]()] if voters on a poll are anonymous [Link to this property](<#(resource)%20realtime_kit.active-session%20%3E%20(method)%20create_poll%20%3E%20(params)%20default%20%3E%20(param)%20anonymous%20%3E%20(schema)>) hide\_votes: Optional\[[bool]()] if votes on an option are visible before a person votes [Link to this property](<#(resource)%20realtime_kit.active-session%20%3E%20(method)%20create_poll%20%3E%20(params)%20default%20%3E%20(param)%20hide_votes%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class ActiveSessionCreatePollResponse: …
data: Optional\[Data] action: Optional\[str] Link to this property
poll: Optional\[DataPoll] id: str ID of the poll Link to this property
options: List\[DataPollOption] Answer options count: float Link to this property text: str Text of the answer option Link to this property
votes: List\[DataPollOptionVote] id: str Link to this property name: str Link to this property
Link to this property
Link to this property question: str Question asked by the poll Link to this property anonymous: Optional\[bool] Link to this property created\_by: Optional\[str] Link to this property hide\_votes: Optional\[bool] Link to this property voted: Optional\[List\[str]] Link to this property
Link to this property
Link to this property success: Optional\[bool] Link to this property
[Link to this property](<#(resource)%20realtime_kit.active-session%20%3E%20(model)%20active_session_create_poll_response%20%3E%20(schema)>) ### Create a poll Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.realtime_kit.active_session.create_poll( meeting_id="meeting_id", account_id="023e105f4ecef8ad9ca31a8372d0c353", app_id="14a396e7-ca44-4937-bf1f-050a69118543", options=["string"], question="question", ) print(response.data) ``` 200 example ``` { "data": { "action": "action", "poll": { "id": "id", "options": [ { "count": 0, "text": "text", "votes": [ { "id": "id", "name": "name" } ] } ], "question": "question", "anonymous": true, "created_by": "created_by", "hide_votes": true, "voted": [ "string" ] } }, "success": true } ``` ##### Returns Examples 200 example ``` { "data": { "action": "action", "poll": { "id": "id", "options": [ { "count": 0, "text": "text", "votes": [ { "id": "id", "name": "name" } ] } ], "question": "question", "anonymous": true, "created_by": "created_by", "hide_votes": true, "voted": [ "string" ] } }, "success": true } ```