> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insighto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Insighto.ai Forms

In this guide, you’ll learn how to build custom forms, connect them with your assistant, and trigger them dynamically during conversations to capture structured information from users.

## Creating Forms and Connect them with Assistants

***

1. Navigate to the Library

Click on **Library** from the left panel in your dashboard. This will expand a dropdown with options like **Forms**, **Tools**, and more.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/1.webp?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=f95b105bd297d75d1926f3bc74eb798d" alt="alt" width="1541" height="919" data-path="images/form/1.webp" />

2. Click on Forms

From the dropdown under **Library**, click on **Forms** to view existing forms or create a new one.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/2.webp?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=f22fbcc06635747dd6e3b7a1c838decb" alt="alt" width="1541" height="919" data-path="images/form/2.webp" />

***

3. Click on Create Form

Hit the **Create Form** button at the top to start building a new form.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/3.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=421b24ca54a2e9faa5bd9e34dd9fc447" alt="alt" width="867" height="529" data-path="images/form/3.png" />

***

4. Define Basic Form Details

Start by selecting the **Form Type** and giving your form a meaningful **Name**.

Use the **Trigger Instruction** field to define a phrase or keyword that, when mentioned by the user during a conversation, will automatically trigger this form.

Choose a label for the **Submit Button** (e.g., “Send”, “Submit”, “Done”).

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/4.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=f986638a024bccd88fc4e94f164f8b66" alt="alt" width="838" height="532" data-path="images/form/4.png" />

***

5. Add a Text Field to Capture User Name

To create a field that captures the user's name, select **Text** as the field type and fill in the following:

* **Name**: Used internally to identify the field. Avoid spaces. Use formats like `FullName` or `full_name`.
* **Description**: A short helper text to guide the user on what to enter in this field.
* **Label**: This is the visible field name on the form. You can use spaces here, like **Full Name**, for better readability.
* **Required**: Enable this checkbox if you want to make this field mandatory for form submission.

After filling in these details, click **Add Field** to include it in the form.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/5.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=4ec3f86b952f898e17cf19d8d34f84a9" alt="alt" width="858" height="517" data-path="images/form/5.png" />

***

6. Add a Phone Number Field

To capture a user's phone number, select **Telephone** as the field type. Fill in the following details:

* **Name**: Internal reference for the field (e.g., `PhoneNumber`). Avoid using spaces.
* **Description**: Text to guide the user (e.g., “Enter your phone number including area code”).
* **Label**: The visible field name shown to users (e.g., **Phone Number**).
* **Required**: Check this box if the phone number must be provided before form submission.
* **Show Country Code**: Enable this checkbox to allow users to select their country code.
* **Default Country Code**: Set a default country code to prefill the field (e.g., `+1` for the US).

Once all fields are filled, click **Add Field** to save it.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/6.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=ef8e436f8c68ae1733dd580b3fadac06" alt="alt" width="864" height="532" data-path="images/form/6.png" />

***

7. Edit or Delete a Form Field

To edit or delete a field:

* Hover over the field and click on it.
* In the left panel, choose **Update** to edit or **Delete** to remove the field.
* Make necessary changes and save, or confirm deletion.

<img src="https://mintcdn.com/insightoai-bc61fe99/7pBSqU3Sh_c8AyWS/images/form/7.png?fit=max&auto=format&n=7pBSqU3Sh_c8AyWS&q=85&s=088ab26bf4336255a067026b19091e55" alt="alt" width="841" height="531" data-path="images/form/7.png" />

***

8. Click on Create Form

<img src="https://mintcdn.com/insightoai-bc61fe99/7pBSqU3Sh_c8AyWS/images/form/8.png?fit=max&auto=format&n=7pBSqU3Sh_c8AyWS&q=85&s=52135a757c96becd3ea8810791c78790" alt="alt" width="862" height="535" data-path="images/form/8.png" />

***

9. Go to Assistants

<img src="https://mintcdn.com/insightoai-bc61fe99/7pBSqU3Sh_c8AyWS/images/form/9.png?fit=max&auto=format&n=7pBSqU3Sh_c8AyWS&q=85&s=5c33faa7323a2eddb2787f557cae3ac8" alt="alt" width="861" height="520" data-path="images/form/9.png" />

***

10. Click on Options

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/10.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=6e1b9f4a2e960eba1cf741b0e78ca30a" alt="alt" width="865" height="519" data-path="images/form/10.png" />

***

11. Click on Edit Assistant

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/11.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=3851fb7df66fbb407142930fb40ea963" alt="alt" width="864" height="516" data-path="images/form/11.png" />

***

12. Click on Advanced

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/12.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=06eb129e51fba676d83c63baeeb354a1" alt="alt" width="853" height="532" data-path="images/form/12.png" />

***

13. Click on Assign Form

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/13.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=fdb95cfebb8bd68ebed0dc79d6eb8b8c" alt="alt" width="862" height="532" data-path="images/form/13.png" />

***

14. Connect the Form

Select the checkbox next to the form you want to connect.

Once selected, click **Close** to confirm and finish the connection.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/form/14.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=9774b11bf6ed9cdc6fe528bbad5f9ab6" alt="alt" width="862" height="531" data-path="images/form/14.png" />
