# Calendly

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** <a href="#how-to-use-calendly-in-zbrain-flow" id="how-to-use-calendly-in-zbrain-flow"></a>

**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: 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://docs.zbrain.ai/zbrain-documentation/zbrain-builder/flows/flow-components/calendly.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.
