For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Help CenterOpenAPI SpecStatus
OverviewInquiriesTransactionsRelaysAPI ReferenceChangelog
OverviewInquiriesTransactionsRelaysAPI ReferenceChangelog
  • Overview
    • Inquiries Overview
    • Inquiry Model Lifecycle
    • Inquiry Templates
  • Managing inquiries
    • Creating Inquiries
    • Resuming Inquiries
    • Accessing Inquiry status and data
  • Hosted Flow integration
      • Parameters
      • Prefilling Fields
      • Redirecting after Inquiry
      • Security
      • Subdomains
      • WebView Considerations
  • Embedded Flow integration
  • Mobile SDK integration
    • Overview
    • Webview
  • Troubleshooting
    • Troubleshooting Steps
    • Troubleshooting Common Issues
LogoLogo
Help CenterOpenAPI SpecStatus
On this page
  • Field values and customers
  • Encoding passed values
  • Phone numbers
Hosted Flow integrationReference guides

Prefilling Fields

Was this page helpful?
Previous

Redirecting After Inquiry

Next
Built with

Use the fields parameter to dynamically preset inquiry field values. In addition, fields will also prefill form values.

All attributes are optional. You only need to include keys for form fields you want prefilled. Individuals can still edit attributes after they’re prefilled.

See Inquiry Fields for more information.

curl
1https://api.withpersona.com/verify?template-id=tmpl_JAZjHuAT738Q63BdgCuEJQre&fields[name-first]=Jane&fields[name-last]=Doe&fields[birthdate]=1957-05-29&fields[address-street-1]=132%20Second%20St.&fields[address-city]=San%20Francisco&fields[address-subdivision]=California&fields[address-postal-code]=93441&fields[address-country-code]=US&fields[phone-number]=+14151231234&fields[email-address]=janedoe%40gmail.com

Field values and customers

Using the fields query string parameter is intended as a convenience for the end user in a manner similar to browser autofill. Because the query string values are handled client-side, they can be freely modified by the end user.

If you must guarantee that field values are unmodified by the end user, you must use the external API to set the field values ahead of time.

Encoding passed values

The fields value should be an object encoded as a string using a library like qs.

If manually passing values, please be sure to make values URL-safe, e.g. with encodeURIComponent in JavaScript. For example, if passing a phone number with an area code, '%2B1...' should be passed instead of '+1...'.

Phone numbers

Please ensure that phone numbers are properly formatted based on the number’s country code. For example, US-based phone numbers should include the prefix +1.

For additional guidance on prefilling fields, see our Help Center.