# How to Create a Form

### 1. Create a Form Action <a href="#id-1tfso74yrzr" id="id-1tfso74yrzr"></a>

1. Navigate to the Threadly app in Slack.
2. Under ⚙️ Customization, click “**Manage Actions**”
3. Select “Create Form Action”

![](https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/01934170-dd5f-7345-9b18-7a284b6bac3f.png)

### 2. Creating a Form Element <a href="#wp3qr4cta80" id="wp3qr4cta80"></a>

Once you’re on the Form screen, click “**Add Form Element.**” Form elements are the fields or inputs that you show to your users.

There are 6 elements you can choose from. One is for displaying purposes (i.e. an intro), one is empty space (for styling), and the other four are inputs for your users to fill in.

All fields can be set to optional. In these cases, it is up to the user to complete that field, or not. The four inputs are:

* **Input:** Displays a one-line input text field
* **Multiline Input:** Displays a multiline input text field
* **Radio Buttons**: Displays a list of options for a user to choose from
* **Datepicker:** Displays a date field for a user to select a date from

![](https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/01934173-3aae-729a-b916-bea989464db8.png)

Once you select an element type, you can now fill in the **label** and the **internal name** for the field. The label is the public-facing text shown to the user, while the internal name is used for API and data purposes. For example:

**What is your favorite color** is a label; while the internal name can be `color`**.**

Repeating this process as many times as needed. As you add each element, your form will begin to take shape.

![](https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/01934176-aa5c-7123-bb0f-246ee7c5c434.png)

### 3. Form Customizations and Settings <a href="#dwafp4sb1ib" id="dwafp4sb1ib"></a>

There are five settings that are configurable to you.

1. **Form Name:** Customize the form name for internal use.

   ![](https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/01934179-6094-7eee-a215-4d3a38ae6d46.gif)
2. **Save Form Data to Profile:** Save the form responses to the user’s profile, for future filtering and use in Threadly.
3. **Webhook Endpoint:** Send your form’s responses to an endpoint, in real-time. The endpoint must be able to accept POST requests. Threadly only tries once, and does not retain webhook logs.
4. **Anonymous Submissions:** Store the user’s responses completely anonymously. Each user will be assigned an anonymous ID, and the user’s true identity will not be shown to the form owner, workspace admin, or Threadly admin.
5. **Limit to specific users:** Restrict completing this form to specific, preset users.

### 4. Publishing Your Form <a href="#iotbb33ozb3" id="iotbb33ozb3"></a>

Once you’re all ready, hit the Publish button at the top of the page. And that’s it!

Forms cannot be deactivated once they’ve been sent in a message, however, you can always edit the form fields and settings.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://threadly.gitbook.io/threadly/actions/form-ctas/how-to-create-a-form.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
