# Poll

> **In short:**\
> Polls streamline scheduling by allowing you to propose multiple time options and invite participants to vote on their preferences. This collaborative approach ensures Meetings are set at times that work best for everyone involved. You can invite both Timebook users and external participants via email, and you'll receive updates as votes are submitted.

## Polls in Timebook

The **Poll** feature streamlines the [Meeting](https://help.timebook.ai/hc/product-guide/calendar-and-scheduling/events/meeting) scheduling process by allowing you to create and share multiple time options. Participants can vote on the times that suit them best, helping you find a slot that aligns with everyone’s availability.

Polls are highly flexible: you can send invitations to Timebook users and external participants via email. You’ll receive updates whenever someone votes, and you can monitor the results as they come in. Ultimately, you decide on the final meeting time, which makes Polls a powerful yet straightforward scheduling tool.

<div align="left"><figure><img src="https://3284049081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCMXgzPoiE4UXP4jn6B8%2Fuploads%2Fgit-blob-5f7e8861a46dbfb1262b17016d91a3ad90d46a1b%2FPoll%20cards%20on%20the%20grid.png?alt=media" alt="" width="563"><figcaption><p>Poll options on the calendar grid before a Meeting is scheduled.</p></figcaption></figure></div>

{% hint style="info" %}
As the host of a Poll, you can select the final meeting time whenever you're ready—you don’t need to wait for all votes to be submitted.
{% endhint %}

***

## Creating a Poll

Polls are managed in the [Agenda module](https://help.timebook.ai/hc/product-guide/calendar-and-scheduling/agenda-module), where you can create them directly on the grid. This approach simplifies scheduling by allowing you to see and select the first time slot you want to share.

{% hint style="info" %}
You can also initiatePoll creation using one of these methods:

* Click the \[**Fast create**] button in the Navigator, select \[**Event**], and then \[**Poll**].
* Click the \[**+**] button above the calendar grid and select \[**Poll**].
  {% endhint %}

To create a Poll on the calendar grid:

{% embed url="<https://go.screenpal.com/watch/cZXrQdnVxSh>" %}
You can create a Poll directly on the grid in the Agenda module.
{% endembed %}

> 1. Click a time slot on the calendar grid, or drag to select a longer period.
> 2. In the menu that appears, select \[**Poll**].
> 3. Give your Poll a meaningful name. This name will be used for the Meeting scheduled from this Poll.
> 4. Add guests, and we’ll invite them to vote in your Poll. You can include members of your Timebook Workplace or enter email addresses of external participants.
> 5. Use the grid to add and move additional time slots for your guests to vote. The time slot you initially selected will already be marked on the grid.
> 6. Customize your Appointment using the available properties. [See below](#properties-specific-to-polls) for more information.
> 7. Click \[**Send**] to save your Poll and invite your guests to vote.

{% hint style="info" %}
You can track your guests’ votes using the Agenda module.

Click one of the cards representing your Poll to see its details. Check your guests’ answers, and if you have enough information, pick one of the options and click \[**Schedule Meeting**].

This ends the Poll and creates a new Meeting for the selected time slot.
{% endhint %}

***

## Voting in a Poll

If you receive an invitation to a Poll, you can vote for one or more time options and submit your response to the sender. If none of the proposed times work for you, select the \[**None of them work**] option. This won’t prevent the sender from scheduling the meeting for those dates, but it ensures they are aware of your limited availability.

If the Poll invitation comes from a member of your [Workplace](https://help.timebook.ai/hc/product-guide/calendar-and-scheduling/events/broken-reference), you’ll receive a notification within Timebook that will allow you to respond directly. If you don’t have a Timebook account, the invitation will be sent to your email with a link to access and vote in the Poll.

{% embed url="<https://go.screenpal.com/watch/cZXrQNnVxWM>" %}
This is how you vote in a Poll through a Timebook notification.
{% endembed %}

> 1. Open the notification containing the Poll invitation.
> 2. Check the boxes next to the options that work for you.
> 3. Optionally, select \[**None of them work**] if none of the suggested times fit your schedule.
> 4. Click \[**Send your vote**] to submit your preferences.
> 5. Wait for the Poll’s sender to review the votes and confirm the final meeting time.

{% hint style="info" %}
If all guests vote for the same time slot, the Poll will automatically convert into a scheduled Meeting without requiring the sender’s confirmation.

If guests all vote for multiple time slots, the Meeting will be scheduled for the earliest available date.
{% endhint %}

***

## Properties specific to Polls

When creating a Poll, you can customize it using some of the standard properties used for Meetings. For more information on these properties, see [#available-properties-when-creating-a-meeting](https://help.timebook.ai/hc/product-guide/calendar-and-scheduling/meeting#available-properties-when-creating-a-meeting "mention")

But we also have additional properties designed specifically for Polls:

<div align="left"><figure><img src="https://3284049081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCMXgzPoiE4UXP4jn6B8%2Fuploads%2Fgit-blob-09709f1b90fe3af653f0e2f8aa6bf961380c3e77%2FPoll%20properties.png?alt=media" alt="" width="563"><figcaption><p>Use the right pane of a Poll card to manage all its properties.</p></figcaption></figure></div>

<table><thead><tr><th width="206">Poll property</th><th>How to use it</th></tr></thead><tbody><tr><td><strong>Meeting duration</strong></td><td><p>Define the length of the proposed Meeting.</p><p>By default, it is set to [<strong>1 hour</strong>], but you can use the dropdown menu to select a different option.</p></td></tr><tr><td><strong>Availability</strong></td><td><p>This area is where you can add Poll options (suggested time slots) for your guests to vote. Click [<strong>Add</strong>] to create an option and define its start and end times. A single Poll can have up to 5 options.</p><p>You can also use the calendar grid on the left to create your Poll options.</p></td></tr><tr><td><strong>Expires after</strong></td><td>Use the dropdown to choose the number of days after which your Poll will expire. Your guests won’t be able to vote after that.</td></tr></tbody></table>

***

## Related articles

[agenda-module](https://help.timebook.ai/hc/product-guide/calendar-and-scheduling/agenda-module "mention")

[meeting](https://help.timebook.ai/hc/product-guide/calendar-and-scheduling/events/meeting "mention")


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.timebook.ai/hc/product-guide/calendar-and-scheduling/events/poll.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
