> For the complete documentation index, see [llms.txt](https://docs.spara.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spara.com/integrations/calendar-integrations/hubspot-calendar.md).

# Hubspot (Calendar)

### Data flows

When your Hubspot integration is connected, Spara books meetings directly through Hubspot's scheduling API and presents a native, Spara-styled booking experience to your leads. Spara pre-fills every field it already knows about the lead — including any custom required questions on your meeting link — and the lead confirms the rest.

<table data-full-width="true"><thead><tr><th>Spara can prepopulate...</th><th>Spara can read from submitted calendar...</th><th>Integration Notes</th></tr></thead><tbody><tr><td><ul><li>Email</li><li>First name</li><li>Last name</li><li>Custom required fields (e.g. company name), when Spara knows the answer</li></ul></td><td><ul><li>Email</li><li>First name</li><li>Last name</li><li>Meeting time and duration</li></ul></td><td>Spara reads the booking details after a meeting has been scheduled and records them on the lead's conversation.</td></tr></tbody></table>

### Implementation

{% hint style="info" %}
How Spara's AI uses your Hubspot calendar must be configured by Spara internally. Please contact your customer service representative to get started.
{% endhint %}

Spara requires a Hubspot calendar URL, for example:

```yaml
https://meetings-na2.hubspot.com/<name>
```

When a lead is offered a meeting, Spara matches the calendar URL against the meeting links in your connected Hubspot portal and renders its native booking UI — available times, meeting length options, and the link's required questions — styled to match your brand.

#### iFrame fallback

The lead sees Hubspot's standard embedded scheduler (an iFrame) instead of the native experience when:

* Your Hubspot integration is not connected, or was connected without the meeting scheduler permission
* The calendar URL doesn't match a meeting link in your connected Hubspot portal
* The meeting link requires a legal-consent checkbox
* Hubspot can't be reached at the moment the calendar is shown

All Hubspot UX can be used by your lead in the iFrame format, so booking always works either way.


---

# 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 dynamically by asking a question.

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

```
GET https://docs.spara.com/integrations/calendar-integrations/hubspot-calendar.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.