> For the complete documentation index, see [llms.txt](https://docs.zbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/flows/flow-components/calendly.md).
# Calendly
Streamline your scheduling by integrating Calendly with ZBrain Flow to automate event management and booking workflows.
The Calendly piece in ZBrain Flow enables seamless scheduling automation by integrating with your Calendly account. This component allows you to send custom API requests to Calendly, enabling operations such as retrieving events, scheduling meetings, and managing availability. With this integration, you can automate scheduling tasks directly within your workflows.
### **How to Use Calendly in ZBrain Flow**
**Step 1: Select Calendly as Your Connection**
Click on the '+' button in the Flow and search for Calendly. Select Calendly.
**Step 2: Create a Connection**
If you haven’t set up a connection yet, follow these steps:
1. Click on ‘Create connection' in the 'Personal Token’ dropdown.
2. A small window will appear where you need to fill in the following details:
1. ‘Connection Name’ – Enter a unique name for the connection.
2. ‘Personal Token’ – Go to [Calendly API Webhooks](https://calendly.com/integrations/api_webhooks), click on "Create New Token," copy the generated token, and paste it into this field.
3. Click ‘Save’ to complete the connection setup.
**Step 3: Configure API Call Details**
* In the ‘URL’ field, enter `https://api.calendly.com` followed by the endpoint you want to use. Example: `/models`.
* Choose the request method in the ‘Method’ field (GET, POST, etc.).
* Click ‘Add Item’ in the ‘Headers’ field to include additional headers. (Authorization headers are injected automatically from your connection).
* Add query parameters in the ‘Query Parameters’ field if required.
* Define the request body in the ‘Body’ field if needed.
* Enable ‘No Error on Failure’ if you want the workflow to continue even if the request fails.
* Set the ‘Timeout (in seconds)’ field to specify the request timeout duration.
---
# 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://docs.zbrain.ai/zbrain-documentation/zbrain-builder/flows/flow-components/calendly.md?ask=&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.