> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/bots/website-mobile-app-bot/3rd-party-integrations/botpenguin-integrations/integrate-botpenguin-with-acuity-scheduling.md).

# Integrate BotPenguin with Acuity Scheduling

### What is Acuity Scheduling?

Acuity Scheduling is an online appointment scheduling platform that helps businesses manage bookings, appointments, and customer scheduling.

Integrating Acuity Scheduling with BotPenguin allows your chatbot to securely connect with your Acuity account and automate appointment-related workflows using your scheduling data.

***

### When should you use this?

Use this integration when:

* You want to connect your Acuity Scheduling account with BotPenguin.
* You need your chatbot to access appointment scheduling information.
* You want to automate booking-related workflows using Acuity Scheduling.

***

### Benefits of Acuity Scheduling Integration

* 📅 Connect your chatbot directly with your Acuity Scheduling account.
* ⚡ Automate appointment and scheduling workflows.
* 🔄 Keep scheduling information connected with your chatbot.
* 🤖 Reduce manual effort while managing appointments.
* 📈 Improve the customer booking experience.

***

### Expected Outcome

After setting this up:

* Your Acuity Scheduling account will be successfully connected to BotPenguin.
* BotPenguin will be able to securely communicate with your Acuity Scheduling account.
* Your chatbot will be ready to use Acuity Scheduling within supported workflows.

{% hint style="info" icon="lightbulb" %}
**Tip:** Test the integration after connecting to verify that your credentials have been configured correctly.
{% endhint %}

### 🔐 Prerequisites

Before setting up this integration, ensure you have:

* An active Acuity Scheduling account.
* Your **User ID**.
* Your **API Key**.
* Permission to access your Acuity Scheduling account settings.

{% hint style="warning" %}
Missing or incorrect credentials will prevent the integration from being connected
{% endhint %}

***

## How to Use Acuity Scheduling

#### 1. Open Integrations

1. Log in to your BotPenguin account.
2. Select the bot you want to configure.
3. Navigate to **Third Party Integrations**.

<figure><img src="/files/cTEnpsk4QE0ehXkJGhkl" alt=""><figcaption></figcaption></figure>

4. Search for **Acuity Scheduling** and Click **Connect**.

<figure><img src="/files/WNSCpf4k4wg0C3RcrOBD" alt=""><figcaption></figcaption></figure>

#### 2. Obtain Your Acuity Scheduling Credentials

If you already have your **User ID** and **API Key**, proceed to the next step.

Otherwise:

1. Log in to your Acuity Scheduling account.

   <https://acuityscheduling.com/>
2. Navigate to **Integrations**.

<figure><img src="/files/diTE14JV8EVUsF0ow8eZ" alt=""><figcaption></figcaption></figure>

3. Click **Custom Integrations**.

<figure><img src="/files/2hA5Ci6QtkCUXV8CBkF9" alt=""><figcaption></figcaption></figure>

4. Scroll down to the **API** section.

<figure><img src="/files/0IQkr4ok7snIek0vue9y" alt=""><figcaption></figcaption></figure>

5. Click **View Credentials**.

<figure><img src="/files/TsWFDFLd1KvRWsmSl5iF" alt=""><figcaption></figcaption></figure>

6. Your **User ID** and **API Key** will be displayed.

<figure><img src="/files/uFP9NMKcbfa0XiEC1jsH" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Keep your API Key secure and do not share it with unauthorized users.
{% endhint %}

***

#### 3. Connect Acuity Scheduling

1. Return to BotPenguin.
2. Enter your **User ID**.
3. Enter your **API Key**.
4. Click **Connect**.

<figure><img src="/files/Ft8irbDqHcu49iLjpjMu" alt=""><figcaption></figcaption></figure>

***

#### 4. Select Your Booking Calendar

After connecting your Acuity Scheduling account, BotPenguin will automatically fetch all calendars available in your account.

1. Open the **Calendar Name** dropdown.
2. Select the calendar you want your chatbot to use for appointment bookings.

<figure><img src="/files/HnKtIqqwPdMw4xMb4203" alt=""><figcaption></figcaption></figure>

Once selected, the calendar's associated **Description** and **Time Zone** will automatically populate.

{% hint style="info" icon="lightbulb" %}
If your Acuity account contains multiple calendars, make sure you select the correct one before proceeding.
{% endhint %}

#### 5. Map Chatbot Questions

To allow Acuity Scheduling to create appointments correctly, you must map the information collected by your chatbot to the corresponding Acuity fields.

1. Under **Question**, select a chatbot question.
2. Under **Map With**, select the matching Acuity Scheduling parameter.
3. Click **Add Parameters** to create additional mappings.
4. Repeat until all required appointment fields have been mapped.

<figure><img src="/files/HjxsgpQfUeEwferjSyB5" alt=""><figcaption></figcaption></figure>

**Example**

| Chatbot Question | Acuity Parameter |
| ---------------- | ---------------- |
| Full Name        | Name             |
| Email Address    | Email            |
| Phone Number     | Phone            |
| Appointment Date | Date             |
| Appointment Time | Time             |

#### 6. Save the Configuration

After completing the calendar selection and question mapping:

1. Review your configuration.
2. Click **Save**.

Your Acuity Scheduling integration is now ready to be used for appointment booking workflows in your ChatBot.

#### 7. Use Acuity Scheduling in Your Chatflow

Once the integration has been configured successfully, you can start using it within your chatbot.

1. Navigate to **Chat Flows**.
2. Open an existing chatflow or create a new one.
3. Add the **Appointment** component onto the canvas.

<figure><img src="/files/UZLRuShYmgTUfNwMULey" alt=""><figcaption></figcaption></figure>

4. Open the component configuration.
5. Under **Make Appointment using**, select **Acuity Scheduling**.

<figure><img src="/files/13HKG8wZLOhz5l2MW5KR" alt=""><figcaption></figcaption></figure>

6. Complete the remaining appointment configuration as required.
7. Save and publish your chatflow.

{% hint style="info" icon="lightbulb" %}
Once selected, all appointments created through this component will use the Acuity Scheduling calendar.
{% endhint %}

***

### 🚫 Limitations

* A valid Acuity Scheduling account is required.
* Invalid or expired API credentials will prevent the integration from connecting.
* Changes to your API Key require reconnecting the integration in BotPenguin.

***

### Best Practices

> 💡 Verify your User ID and API Key before connecting.

> ⚠️ Keep your API Key secure and never share it publicly.

> 🚀 Test the connection after setup to ensure the integration is working correctly.

> 🎯 Reconnect the integration if your API credentials are updated.

***

### Troubleshooting

<details>

<summary>Unable to connect Acuity Scheduling</summary>

**Likely Cause:** The User ID or API Key was entered incorrectly.

**Resolution:** Verify that your **User ID** and **API Key** have been entered correctly, then try connecting again.

</details>

<details>

<summary>Authentication failed</summary>

**Likely Cause:** The API Key is invalid, outdated, or has been regenerated.

**Resolution:** Generate or retrieve the latest **API Key** from your Acuity Scheduling account and update the integration.

</details>

<details>

<summary>Unable to locate the API credentials</summary>

**Likely Cause:** You are not viewing the correct section of your Acuity Scheduling account.

**Resolution:** Navigate to **Integrations → Custom Integrations → API → View Credentials** to access your **User ID** and **API Key**.

</details>

<details>

<summary>Integration disconnected after updating credentials</summary>

**Likely Cause:** The previously connected API Key is no longer valid.

**Resolution:** Re-enter the updated **API Key** and reconnect the integration.

</details>

### FAQs

<details>

<summary>What happens if I regenerate my API Key?</summary>

If you generate a new API Key in Acuity Scheduling, you'll need to update it in BotPenguin by editing the existing integration or reconnecting it.

</details>

<details>

<summary>Can I change the calendar used by my chatbot later?</summary>

Yes. You can edit the integration configuration and select a different calendar at any time. Future appointments will use the updated calendar.

</details>

<details>

<summary>Why aren't my calendars appearing after connecting Acuity Scheduling?</summary>

Ensure you've connected the correct Acuity Scheduling account and that at least one active calendar is available. Refresh the integration after reconnecting if necessary.

</details>

<details>

<summary>Will changes made in Acuity Scheduling automatically reflect in BotPenguin?</summary>

Yes. BotPenguin retrieves the latest scheduling information from your connected Acuity Scheduling account whenever the integration is used.

</details>

<details>

<summary>Can multiple chatflows use the same Acuity Scheduling configuration?</summary>

Yes. A single Acuity Scheduling configuration can be reused across multiple chatflows without creating separate integrations.

</details>

<details>

<summary>What happens if I disable an Acuity Scheduling configuration?</summary>

The integration will no longer be available for appointment-related actions until the configuration is enabled again.

</details>

<details>

<summary>Can I edit the mappings after creating the integration?</summary>

Yes. You can modify the mapped questions, calendar selection, or other configuration settings whenever your booking workflow changes.

</details>

<details>

<summary>Why are appointments not being created even though the integration is connected?</summary>

Verify that all required chatbot questions are correctly mapped, the appropriate calendar is selected, and your Acuity Scheduling account has available appointment types.

</details>

<details>

<summary>Can I use one Acuity Scheduling account across multiple bots?</summary>

Yes. The same Acuity Scheduling configuration can be used across multiple BotPenguin bots, depending on your workflow requirements.

</details>

<details>

<summary>Does deleting an integration remove existing appointments from Acuity Scheduling?</summary>

No. Removing the integration from BotPenguin does not delete appointments that have already been created in your Acuity Scheduling account.

</details>

***

### Related Articles

{% content-ref url="/pages/j4bmyhJP102ZPIbXx43y" %}
[Components in Chatflow](/bots/website-mobile-app-bot/website-manage-chatflow/components-in-chatflow.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZOWdzzbfimFouHgzbb9Q" %}
[3rd party Integrations](/bots/website-mobile-app-bot/3rd-party-integrations.md)
{% endcontent-ref %}

***

### Support

If you still have questions for our team, write to us at [**support@botpenguin.com**](mailto:support@botpenguin.com). We'll get back to you within 48 hours.

***

### 🎉 Completion

🎉 Congratulations! You have successfully connected your Acuity Scheduling account with BotPenguin.