> For the complete documentation index, see [llms.txt](https://help.distro.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.distro.so/routing/outbound-routing/magic-slots.md).

# Magic Slots

Magic Slots lets an allowed booker propose **two to five available times** from an outbound handoff. The prospect chooses a time from the message instead of starting with a full calendar.

For personal or group booking links, use [Offer times](/integrations/chrome-extension/offer-times.md). This page covers proposed times from an Outbound Router.

### Before you start

Your workspace and the active router must allow Magic Slots. Complete the handoff's required details, resolve prospect identity, and review participants and timezone. The form must be ready for this scheduling path.

Admins enable **Allow Magic Slots** in the router's **Booking & sharing** panel. **Proposal expiry** is 1–14 whole days and cannot extend beyond the source session expiry.

### Propose times to a prospect

{% stepper %}
{% step %}

#### Open Share availability

Start or reopen the [sales handoff](/routing/outbound-routing/book-a-meeting.md). Choose **Share availability**. It is available when required details are ready and Magic Slots is enabled.

From the scheduling calendar, check the timezone, participants, and the week you are viewing before choosing times.
{% endstep %}

{% step %}

#### Select two to five times

Select available slots in the calendar. The selection panel shows how many are chosen. Use the week controls to offer useful alternatives.

These selections do not hold a time, reserve a host, or consume distribution credit.
{% endstep %}

{% step %}

#### Create and copy the snippet

Choose **Vertical** or **Horizontal**, then **Create snippet**. Review the proposed dates, timezone, and expiry.

Use **Copy snippet** to paste the formatted choices into an email. **Copy plain text** provides a text alternative. The email preview shows what you are sharing; **View HTML source** is available if you need the underlying markup.

Choose **Done** to return to the calendar, or **View snippet** to reopen the result. When launched from Gmail, Distro returns the snippet to the originating draft; if that draft moved or closed, copy it manually.
{% endstep %}

{% step %}

#### Handle changes before booking

Availability is checked again when the prospect chooses a time. If a slot is no longer available or the proposal expires, offer current times again.

Use **Revoke** to stop an issued proposal from accepting a booking. Changing the sales handoff revokes its prior offers. A completed booking remains unchanged.
{% endstep %}
{% endstepper %}

![Magic Slots selection in dark mode with two proposed times, layout choice, and Create snippet.](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQA3GQNrIYVrPQ90NBwRa%2Fuploads%2FMJhfXpq1FeTJIO1nr6dN%2Foutbound-magic-slots-dark.png?alt=media\&token=2e17e2c0-fbcc-4242-bd7b-3b78c81a40f4)

*Two example times are selected. They remain available to others until a booking is confirmed.*

### Troubleshoot proposed times

| Symptom                                     | Check                                                                                                     |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Share availability is disabled or missing   | Complete required details, resolve CRM identity, and confirm Magic Slots is enabled in the active router. |
| No times appear                             | Review timezone, participants, event type, host calendars, and the selected week.                         |
| Snippet creation asks for more details      | Complete required fields and reroute before proposing times.                                              |
| An offered time no longer works             | Load current availability and issue a fresh proposal. Offers do not reserve slots.                        |
| A copied offer expired                      | Check the proposal and session expiry, then create a new offer if the handoff is still usable.            |
| The Gmail draft did not receive the snippet | Use **Copy snippet** or **Copy plain text** from the generated result.                                    |

### Return to booking

Creating a snippet or clearing the selected times keeps the calendar in Magic Slots mode. It also keeps that mode when you reopen the handoff. Use **Back** to return to prospect details and choose **Book a meeting** when you want to make a booking yourself.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.distro.so/routing/outbound-routing/magic-slots.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.