docs: add closeModal() API documentation for embed instructions

- Add comprehensive closeModal() documentation to embed-instructions.mdx
- Include usage examples for both namespaced and non-namespaced embeds
- Add common use case example in embed-events.mdx
- Document supported embed types and error handling
- Include migration note from internal API

Co-Authored-By: hariom@cal.com <hariombalhara@gmail.com>

Author: devin-ai-integration[bot]

embedding/embed-events.mdx

@@ -91,6 +91,20 @@ _`It deprecates rescheduleBookingSuccessful event.`_
 - `isRecurring`: `boolean` - Whether the booking is recurring
 - `allBookings`: `object` - Array of objects with `startTime` and `endTime`. Applicable only if `isRecurring` is `true`
 
+**Example: Close the modal after successful booking**
+```js
+<script>
+  Cal("on", {
+    action: "bookingSuccessfulV2",
+    callback: () => {
+      Cal("closeModal"); // Programmatically close the modal
+    },
+  });
+</script>
+```
+
+See [Embed Instructions](/embedding/embed-instructions#close-modal) for more details on the `closeModal()` method.
+
 ### `linkReady`
 
 **Description:** Tells that the link is ready to be shown now.

embedding/embed-instructions.mdx

@@ -39,4 +39,56 @@ To open cal link on some action, make it pop open instantly by using `preload`.
 </script>
 ```
 
-- `calLink` - Cal Link that you want to embed e.g. john. Just give the username. No need to give the full URL https://cal.com/john
+- `calLink` - Cal Link that you want to embed e.g. john. Just give the username. No need to give the full URL https://cal.com/john
+
+#### Close modal
+
+Programmatically closes a modal-based embed shown as a pop-up (for example, when opened via an element click or the floating button).
+
+```js
+<script>
+  Cal("closeModal");
+</script>
+```
+
+**Supported embed types:**
+- Pop-up via element click
+- Floating button pop-up
+
+**Not supported:**
+- Inline embed (calling this for inline embeds will throw an error: "closeModal() is only supported for modal-based embeds (ModalBox and FloatingButton). It cannot be used with inline embeds.")
+
+**Namespaced usage:**
+```js
+<script>
+  Cal.ns.yournamespace("closeModal");
+</script>
+```
+
+**Common use case - Close the modal after a successful booking:**
+```js
+<script>
+  Cal("on", {
+    action: "bookingSuccessfulV2",
+    callback: () => {
+      Cal("closeModal");
+    },
+  });
+</script>
+```
+
+**Namespaced example:**
+```js
+<script>
+  Cal.ns.yournamespace("on", {
+    action: "bookingSuccessfulV2",
+    callback: () => {
+      Cal.ns.yournamespace("closeModal");
+    },
+  });
+</script>
+```
+
+<Note>
+This replaces any previous internal usage like `cal.instance.actionManager.fire("__closeIframe")`. If you were using this internal method, please migrate to the new `closeModal()` API.
+</Note>