Skip to main content
The Auto Apply API discovers form fields and reports their types. Each type has a specific value format you should use when calling Set Answers.

Type Reference

TypeDescriptionValue Format
TextSingle-line text input (text, email, tel, url)The string value to type
TextAreaMulti-line textareaThe string value to type
SelectDropdown / select menuThe option value to select
MultiSelectMulti-select dropdown or tokenized selectorComma-separated option values
RadioRadio button groupThe option value to select
CheckboxCheckbox (single or group)"true" or "false" (single), comma-separated values (group)
FileFile upload inputLocal file path to upload
DateDate input or date pickerDate string (YYYY-MM-DD)
NumberNumeric inputNumeric string
TypeaheadAutocomplete / comboboxText to type; use typeahead_selection for the option to click
ToggleToggle / switch control"true" or "false"
RichTextRich text editor (Quill, TinyMCE, etc.)HTML or plain text content

Answer Object Schema

{
  "field_id": "first_name",
  "type": "Text",
  "value": "Jane",
  "selector": "input[name='first_name']",
  "clear_first": true,
  "typeahead_selection": null
}
PropertyTypeRequiredDescription
field_idstringField identifier from the fields array
typestringField type matching the discovered type
valuestringValue to set (format depends on type)
selectorstringCSS selector (use the one from field discovery)
clear_firstbooleanClear field before typing (default: false)
typeahead_selectionstringFor Typeahead: the dropdown option text to click

Typeahead Fields

Typeahead (autocomplete) fields require two values:
  1. value — The text to type into the input (triggers the dropdown)
  2. typeahead_selection — The exact text of the dropdown option to select
{
  "field_id": "location",
  "type": "Typeahead",
  "value": "San Fran",
  "typeahead_selection": "San Francisco, CA"
}

File Fields

File upload fields accept a local file path:
{
  "field_id": "resume",
  "type": "File",
  "value": "/path/to/resume.pdf"
}
Check the constraints object on File fields for accepted_file_types and max_file_size_bytes.