# Calendar Actions

Calendar Actions are a type of Threadly Action that embed a booking experience directly in your Slack message. Instead of sending a scheduling link and hoping someone clicks it, recipients pick a time in a Slack modal — without opening a browser tab.

Available on **Premium**.

## Supported calendar providers

| Provider             | Booking experience                                              |
| -------------------- | --------------------------------------------------------------- |
| **Cal.com**          | Fully in-Slack — availability shown and confirmed inside Slack  |
| **HubSpot Calendar** | Fully in-Slack — powered by your HubSpot meeting scheduler      |
| **Calendly**         | Opens Calendly in browser (via Website CTA — no in-Slack modal) |

## How it works for recipients

1. They see a **"Book a Meeting"** button (or whatever label you choose) in the Threadly message.
2. Clicking it opens a **Slack modal** showing your live availability.
3. They select a time and confirm.
4. The meeting is booked — both parties get a confirmation and calendar invite.

No context-switching. No scheduling ping-pong.

## When to use Calendar Actions

Calendar Actions work best anywhere a scheduling link would — but with higher conversion because everything stays in Slack:

* Sales follow-up calls in Slack Connect channels
* Customer onboarding, QBRs, and training sessions
* Support escalations that need a live call
* Internal syncs, reviews, and handoffs
* Any [Workflow](/threadly/workflows/introduction-to-workflows.md) message where "book time" is the next step

## Setting up a Calendar Action

### Cal.com

See the full guide: [Cal.com Integration](/threadly/integrations/cal.com.md)

### HubSpot Calendar

See the **HubSpot Calendar Actions** section in the [HubSpot Integration](/threadly/integrations/hubspot.md) guide.

## Adding a Calendar Action to a message

Once created, attach the calendar action to any message:

1. In the message composer, click **Add Action**.
2. Select your calendar action from the list.
3. The booking button appears at the bottom of the message.

Calendar Actions can also be added to [Workflow](/threadly/workflows/introduction-to-workflows.md) send steps, so booking prompts can be automated.


---

# 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://threadly.gitbook.io/threadly/actions/calendar-actions.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.
