diff --git a/fern/docs.yml b/fern/docs.yml
index 0ecf0889f..022902a48 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -115,6 +115,9 @@ navigation:
- page: Inbound customer support
path: examples/inbound-support.mdx
icon: fa-light fa-phone-volume
+ - page: Appointment scheduling
+ path: examples/appointment-scheduling.mdx
+ icon: fa-light fa-calendar-check
- page: Outbound sales
path: examples/outbound-sales.mdx
icon: fa-light fa-money-bill-wave
diff --git a/fern/examples/appointment-scheduling.mdx b/fern/examples/appointment-scheduling.mdx
new file mode 100644
index 000000000..b562f9211
--- /dev/null
+++ b/fern/examples/appointment-scheduling.mdx
@@ -0,0 +1,149 @@
+---
+title: Appointment Scheduling Agent 📅
+subtitle: Build an AI agent using workflows to schedule appointments via phone calls with Google Calendar integration.
+slug: examples/appointment-scheduling
+description: A comprehensive guide to building a voice AI agent that handles appointment scheduling with Google Calendar integration.
+---
+
+By following this example, you'll learn how to:
+
+* Create a voice AI agent using workflows to handle inbound appointment scheduling calls.
+* Build custom tools to check calendar availability and book appointments.
+* Integrate with Google Calendar for real-time scheduling.
+* Create an automated test suite to ensure your scheduling agent works correctly.
+
+## Prerequisites
+
+* A [Vapi account](https://dashboard.vapi.ai/).
+* A Google Account (for Google Calendar integration).
+
+---
+
+## 1. Configuring Google Calendar Integration
+
+
+
+ Go to [dashboard.vapi.ai](https://dashboard.vapi.ai) and log in to your account.
+
+
+ Click `Workflows` in the left sidebar.
+
+
+ - Click `Create Workflow`.
+ - Change workflow name to `Appointment Scheduling Workflow`.
+
+
+ - Update first step to
+
+
+
+
+
+---
+
+## 2. Creating Tools for Use in Workflows
+
+
+
+ Open your [dashboard.vapi.ai](https://dashboard.vapi.ai) and click `Tools` in the left sidebar.
+
+
+ - Click `Create Tool`.
+ - Select `Function` as your tool type.
+ - Change tool name to `check_availability`.
+ - Add the following function description:
+
+ ```txt title="Function Description" wordWrap
+ Check calendar availability for a specific date and time range. Use this before attempting to book any appointment.
+ ```
+
+ - Save the tool.
+
+
+ - Click `Create Tool`.
+ - Select `Function` as your tool type.
+ - Change tool name to `book_appointment`.
+ - Add the following function description:
+
+ ```txt title="Function Description" wordWrap
+ Book an appointment after confirming availability. Only use this after checking availability first.
+ ```
+
+ - Save the tool.
+
+
+ - Click `Create Tool`.
+ - Select `Function` as your tool type.
+ - Change tool name to `book_appointment`.
+ - Add the following function description:
+
+ ```txt title="Function Description" wordWrap
+ Book an appointment after confirming availability. Only use this after checking availability first.
+ ```
+
+ - Save the tool.
+
+
+
+
+
+---
+
+## 3. Creating an Appointment Scheduling Workflow
+
+
+
+ Go to [dashboard.vapi.ai](https://dashboard.vapi.ai) and log in to your account.
+
+
+ Click `Workflows` in the left sidebar.
+
+
+ - Click `Create Workflow`.
+ - Change workflow name to `Appointment Scheduling Workflow`.
+
+
+ - Update first step to
+
+
+
+
+
+---
+
+## 4. Assigning a phone number to a workflow
+
+
+
+ Open your [dashboard.vapi.ai](https://dashboard.vapi.ai) and click `Phone Numbers` in the left sidebar.
+
+
+ - Click `Create Phone Number`.
+ - Stick with `Free Vapi Number`.
+ - Enter your preferred area code (e.g. `415`).
+
+
+ - Set the `Phone Number Name` to `Appointment Scheduling Line`.
+ - Under `Inbound Settings` find `Assistant` dropdown and select `Sophia` from the list.
+ - Changes are saved automatically.
+
+
+
+
+
+---
+
+## Next Steps
+
+Congratulations! You've built a comprehensive appointment scheduling assistant that can handle inbound calls, check calendar availability, and book appointments with proper confirmation.
+
+Consider reading the following guides to further enhance your assistant:
+
+* [**GoHighLevel Integration**](https://docs.vapi.ai/tools/go-high-level) - Connect with GoHighLevel for advanced CRM and calendar management.
+* [**Google Calendar Integration**](https://docs.vapi.ai/tools/google-calendar) - Integrate directly with Google Calendar for real-time availability.
+* [**Knowledge Bases**](https://docs.vapi.ai/knowledge-base/) - Add FAQ capabilities for common scheduling questions.
+* [**Custom Keywords**](https://docs.vapi.ai/customization/custom-keywords) - Set up keywords for quick actions like "cancel" or "reschedule".
+
+
+Need help? Chat with the team on our [Discord](https://discord.com/invite/pUFNcf2WmH) or mention us on [X/Twitter](https://x.com/Vapi_AI).
+