Using form variables

Overview

This topic explains how to use form variables to collect configuration data from members when they begin using your integration. Most integrations need to collect one or more pieces of configuration data that support the integration, such as API tokens or webhook endpoints.

Build form variables

To support your configuration, you must describe a set of formVariables that define your configuration properties. The formVariables populate a form in the LaunchDarkly user interface (UI) that members complete to add your integration.

Here’s an example:

1
"formVariables": [
2
    {
3
        "key": "name",
4
        "name": "Name",
5
        "type": "string"
6
    },
7
    {
8
        "key": "webhookUrl",
9
        "name": "Incoming webhook URL",
10
        "description": "Enter your Microsoft Teams [incoming webhook URL](https://example-documentation.com).",
11
        "defaultValue": "https://example.com/inbound_webhook",
12
        "type": "url",
13
        "isSecret": true
14
    }
15
]

Here’s how the formVariables entry above displays on the LaunchDarkly Integrations page:

Form variables apply to the entire integration configuration. There are no capability-specific form variables.

Here are the form variables you need to supply:

• key, name, description, and type are required.
• formVariables[].description is used as a field label on the UI. You can use simple Markdown to link a word or phrase to an external URL.
• Optionally, you can set isSecret or isOptional if necessary, or provide guidance with placeholder and defaultValue. If you provide a defaultValue, you must also set isOptional to true and vice versa.

Accepted form variable types are string, boolean, uri, enum, and dynamicEnum.

To learn more, read the manifest schema.