diff --git a/fern/docs.yml b/fern/docs.yml
index b07544abe..aec9dab3f 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -184,6 +184,10 @@ navigation:
path: squads-example.mdx
- page: Silent Transfers
path: squads/silent-transfers.mdx
+ - section: Phone Numbers
+ contents:
+ - page: Free Telephony
+ path: phone-numbers/free-telephony.mdx
- section: Test
contents:
- page: Manual Testing
diff --git a/fern/phone-numbers.mdx b/fern/phone-numbers.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/fern/phone-numbers/free-telephony.mdx b/fern/phone-numbers/free-telephony.mdx
new file mode 100644
index 000000000..ef8822e13
--- /dev/null
+++ b/fern/phone-numbers/free-telephony.mdx
@@ -0,0 +1,56 @@
+---
+title: Creating Free Phone Numbers
+subtitle: Creating free phone numbers on the Vapi platform.
+slug: free-telephony
+---
+
+This guide details how to create free phone numbers on the Vapi platform, which you can use with your assistants or squads.
+
+
+ ### Head to the “Phone Numbers” tab in your Vapi dashboard.
+
+
+
+
+
+ ### Click on “Create a Phone Number”
+
+
+
+
+
+ ### Within the "Free Vapi Number" tab, enter your desired area code
+
+
+ Currently, only US phone numbers can be directly created through Vapi.
+
+
+
+
+
+
+ ### Vapi will automatically allot you a random phone number — free of charge!
+
+
+ It takes a couple of minutes for the phone number to be fully activated. During this period, calls will not be functional.
+
+
+
+
+
+
+
+
+### Frequently Asked Questions
+
+
+
+ For now, each wallet can have up to 10 free numbers. This limit ensures we can continue offering reliable, high-quality service to everyone.
+
+
+ Not at this time. You can still bring in global numbers using our phone number import feature.
+
+
+ None at all. We’re simply passing on the cost efficiencies we’ve gained through robust engineering and volume partnerships.
+
+
\ No newline at end of file
diff --git a/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx b/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx
index 41f4bf7b6..850d53ca6 100644
--- a/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx
+++ b/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx
@@ -6,14 +6,14 @@ Navigate to the "Phone Numbers" section & click the "Create Phone Number" button
-We will use the area code `415` for our phone number (these are area codes domestic to the US & Canada).
+We will use the area code `415` for our phone number (these are area codes domestic to the US).
- Currently, only US & Canada phone numbers can be directly created through Vapi. Phone numbers in
+ Currently, only US phone numbers can be directly created through Vapi. Phone numbers in
other regions must be imported, see our [phone calling](/phone-calling) guide.
diff --git a/fern/snippets/quickstart/phone/get-a-phone-number.mdx b/fern/snippets/quickstart/phone/get-a-phone-number.mdx
index 6d9edd3b3..8a5b7fe11 100644
--- a/fern/snippets/quickstart/phone/get-a-phone-number.mdx
+++ b/fern/snippets/quickstart/phone/get-a-phone-number.mdx
@@ -17,14 +17,14 @@ There are **2 ways** we can get a phone number into our Vapi account:
- We will use the area code `415` for our phone number (these are area codes domestic to the US & Canada).
+ We will use the area code `415` for our phone number (these are area codes domestic to the US).
- Currently, only US & Canada phone numbers can be directly created through Vapi. Phone numbers in
+ Currently, only US phone numbers can be directly created through Vapi. Phone numbers in
other regions must be imported, see our [phone calling](/phone-calling) guide.
diff --git a/fern/static/images/quickstart/dashboard/buy-a-phone-number.png b/fern/static/images/quickstart/dashboard/buy-a-phone-number.png
deleted file mode 100644
index 3a4a64c99..000000000
Binary files a/fern/static/images/quickstart/dashboard/buy-a-phone-number.png and /dev/null differ
diff --git a/fern/static/images/quickstart/dashboard/buy-vapi-phone-number-modal.png b/fern/static/images/quickstart/dashboard/buy-vapi-phone-number-modal.png
index 5a3860b41..355f6e896 100644
Binary files a/fern/static/images/quickstart/dashboard/buy-vapi-phone-number-modal.png and b/fern/static/images/quickstart/dashboard/buy-vapi-phone-number-modal.png differ
diff --git a/fern/static/images/quickstart/dashboard/create-vapi-phone-number-empty-view.png b/fern/static/images/quickstart/dashboard/create-vapi-phone-number-empty-view.png
new file mode 100644
index 000000000..8c281617a
Binary files /dev/null and b/fern/static/images/quickstart/dashboard/create-vapi-phone-number-empty-view.png differ
diff --git a/fern/static/images/quickstart/dashboard/create-vapi-phone-number.png b/fern/static/images/quickstart/dashboard/create-vapi-phone-number.png
index ac134e8ce..244314b31 100644
Binary files a/fern/static/images/quickstart/dashboard/create-vapi-phone-number.png and b/fern/static/images/quickstart/dashboard/create-vapi-phone-number.png differ
diff --git a/fern/static/images/quickstart/dashboard/phone-number-config.png b/fern/static/images/quickstart/dashboard/phone-number-config.png
deleted file mode 100644
index 9ceb7b35c..000000000
Binary files a/fern/static/images/quickstart/dashboard/phone-number-config.png and /dev/null differ
diff --git a/fern/static/images/quickstart/dashboard/vapi-phone-numbers-sidebar-selection.png b/fern/static/images/quickstart/dashboard/vapi-phone-numbers-sidebar-selection.png
new file mode 100644
index 000000000..d42a27044
Binary files /dev/null and b/fern/static/images/quickstart/dashboard/vapi-phone-numbers-sidebar-selection.png differ