---
title: "Text Input Place"
description: "Collect information from recipients with text input fields in Power Automate flows"
canonical: "https://signatureapi.com/docs/integrations/power-automate/places/text-input"
source: "https://signatureapi.com/docs/integrations/power-automate/places/text-input.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T12:52:44Z"
---

# Text Input Place

Collect information from recipients with text input fields in Power Automate flows

_Last verified against API version 1.18.0._

**Text input places** allow you to request specific information from recipients during the signing ceremony. These are similar to _fields_ in other electronic signature platforms.

> **Warning:** Input fields are only available in envelopes with sequential signing.

You can position Text Input Places inside a document using either [fixed positions](https://signatureapi.com/docs/integrations/power-automate/places/positioning/#fixed-positions) or [placeholders](https://signatureapi.com/docs/integrations/power-automate/places/positioning/#placeholders).

Use the [Add a place: Text Input](https://signatureapi.com/docs/integrations/power-automate/actions/add-place-text-input) action to add a text input place to a document within an envelope.

## Hints and Prompts

You can use `hint` and `prompt` properties to guide recipients while filling out text fields:

- **Hint**: A message shown as a tooltip when the user hovers over or focus on the text field. Set it using the `hint` property.
- **Prompt**: A placeholder-style message displayed inside the text field. Set it using the `prompt` property.

For example, a text input place configured with the following properties:

![The Add a place Text Input action with Hint set to Your 8-digit reference code and Prompt set to 12345678, with an arrow pointing to them](https://signatureapi.com/docs/integrations/power-automate/images/places-text-input-hint.webp)

During the signing ceremony, the field will appear like this:

![A Reference code text input showing the hint Your 8-digit reference code and the prompt text 12345678](https://signatureapi.com/docs/images/text-input-guides.webp)

## Format Validation

The `format` property allows you to control the type of input users can enter into a field. This property can accept either predefined formats or custom regular expressions.

### Predefined Formats

You can use one of the following predefined values:

| Format       | Description   |
| ------------ | ------------- |
| `email`      | Email address |
| `zipcode-us` | US ZIP code   |

> **Tip:** More predefined formats are coming soon! Have a specific format in mind? [Let us know](https://signatureapi.com/support).

### Custom Regular Expressions

If the predefined formats don’t meet your needs, you can define a custom format using a regular expression. Enclose the regular expression in forward slashes. For example, to require exactly 8 numeric digits:

![The Add a place Text Input action with the Format advanced parameter set to a regular expression for exactly 8 digits, highlighted by an arrow](https://signatureapi.com/docs/integrations/power-automate/images/places-text-input-format.webp)

### Adding a Custom Message

To guide users during input, you can include a `format_message` property. This message is displayed when the input doesn’t match the required format. For example:

![The Add a place Text Input action with a Format regular expression for 8 digits and Format Message Must be exactly 8 numeric digits (0-9)](https://signatureapi.com/docs/integrations/power-automate/images/places-text-input-format-message.webp)

During the signing ceremony, the `format_message` is displayed to help users understand the input requirements:

![A text input holding 123 with the error Must be exactly 8 numeric digits (0-9) under the hint Your 8-digit reference code](https://signatureapi.com/docs/images/text-input-format-message.webp)

## Example

For example, a text input field can be used to place a text box at the placeholder **\[\[buyer\_email]]**. This allows the recipient with the key "buyer" to provide their email address. This field is set to optional.

![The Add a place Text Input action with Hint Please enter your email, an example email as Prompt, Requirement optional and Format set to email](https://signatureapi.com/docs/integrations/power-automate/images/places-text-input-email.webp)

## Parameters

#### `type` (enum, path, required)

Specifies the type of place.

For a text place, the value must be `text_input`.

#### `key` (string, path, required)

A user-provided key that identifies a place within a document.

It must be up to 32 characters long, using only lowercase letters, numbers, or underscores, and it must begin with a letter.

#### `recipient_key` (string, path, required)

A user-provided key that identifies a recipient within an envelope.

It must match to one of the keys in the envelope's recipient list.

#### `capture_as` (string, path)

A user-defined identifier used to store the value entered by the recipient. This value will be included in the `captures` object of the Envelope.

#### `hint` (string, path)

A tooltip message displayed over the input text field during the signing ceremony.

#### `prompt` (string, path)

A placeholder message shown inside the input text field during the signing ceremony.

#### `requirement` (enum, path)

Specifies whether the recipient must fill this field to complete the signing ceremony.

Possible values are `required` or `optional`. The default is `required`.

#### `format` (enum or regex, path)

Defines the validation format for the user's input.

Accepted values are `email` or `zipcode-us`. Alternatively, a regular expression can be used, enclosed in forward slashes.

Learn more in [Format Validation](https://signatureapi.com/docs/integrations/power-automate/places/text-input#format-validation).

#### `format_message` (string, path)

The message displayed when the user's input does not match the required format.

Learn more in [Adding a Custom Message](https://signatureapi.com/docs/integrations/power-automate/places/text-input#adding-a-custom-message).
