Form data

Use the form URL encoded data request type to add various parameters to your request body.

Actions

The following parameter actions are enabled:

Add
Click to add a parameter.
Edit
Mouse over the three dots icon of the parameter that you want to edit and click the edit icon.
Delete
Delete the selected parameters.

Parameters table

View the following parameter details in the table.

Table item Description
Value is user provided Shows if the value is user provided.
  • Shows Yes if the value is user provided. The package user will need to provide an appropriate value when configuring this parameter in the Bot editor or API Task editor.
  • Shows No if the value is hard coded. The package user will not be able to view this value in the Bot editor or API Task editor. This value is sent as part of the header.
Key Shows the key name. The key name is not displayed to the package user in the Bot editor or API Task editor. This name is sent as part of the header.
Key type Shows the type of form data. It determines how the data is interpreted and handled.
  • Text: Represents a simple text input. The content is treated as plain text (text/plain). This is suitable for data like names, addresses, or descriptions.
  • File: Represents a binary file upload. The content is the raw data of the uploaded file itself. This is used for uploading documents, images, or other binary data.
    Note: The file type field is always user-defined, and users can upload files through the Bot editor.
Value Shows the parameter value. The package user will be able to view this value in the Bot editor or API Task editor and can update this value.
Label Shows the parameter label. The package user will be able to view this label for the parameter in the Bot editor or API Task editor.
Description Shows the parameter description. The package user will be able to view this description for the parameter in the Bot editor or API Task editor.

Add request body parameters

  1. Click the Request body tab.
  2. From the Type drop-down list, select Form data.
  3. Click Add parameter or the plus (+) icon on the top of the table to add a parameter.
  4. In the Key field, enter an appropriate key. The key name is not displayed to the package user in the Bot editor or API Task editor. This name is sent as part of the header.
  5. Select one of the following options:
    Hard coded Enter a value that is hard-coded for the parameter. The package user will not be able to view this value in the Bot editor or API Task editor. This value is sent as part of the header.
    User provided
    1. Select whether you want the input value type to be secured. When you select secured, you will be able enter the parameter through a credential, variable, or insecure string.
    2. Select if this field is mandatory.
    3. Enter a value. The package user will be able to view this value in the Bot editor or API Task editor and can update this value.
    4. Enter a label. The package user will be able to view this label for the parameter in the Bot editor or API Task editor.
    5. (Optional) Enter a description. The package user will be able to view this description for the parameter in the Bot editor or API Task editor. It will appear as help text in the editor.