FAQ
Developer hub
Plugin Input Fields
Dynamic dropdown

Dynamic dropdown


Dynamic Dropdowns are input fields that fetch their list of options from an API or based on another field’s input. Unlike static dropdowns, which show a fixed list, dynamic dropdowns update in real-time, offering a flexible and powerful way to present relevant options to users.


Why Use Dynamic Dropdowns?

  • Show live data from your external app (e.g., contact lists, categories, status codes)

  • Reduce errors by offering only valid, current choices

  • Create dependent dropdowns (e.g., country → state → city)


Use Cases

Example

Description

List CRM pipelines

Fetch stages from your connected CRM via API

Show contact labels

Load tags from user’s account dynamically

Select project or workspace

Populate options based on authentication or prior input

Country → State selector

Chain dropdowns where one depends on another


How It Works

  1. Define the input field type as "dynamic_dropdown"

  2. Specify an API call that fetches the dropdown options

  3. viaSocket will:

    • Make the API request (with token/headers if needed)

    • Parse the response

    • Display the returned list as dropdown choices

Features

  • 🔁 Refresh on change – fetch data again when another field is updated

  • 🔐 Works with OAuth / Basic Auth / No Auth

  • 📄 Supports nested API responses (via dataPath)

  • 🌐 Multiple dynamic dropdowns in one form