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
| Type | Description | Value Format |
|---|
| Text | Single-line text input (text, email, tel, url) | The string value to type |
| TextArea | Multi-line textarea | The string value to type |
| Select | Dropdown / select menu | The option value to select |
| MultiSelect | Multi-select dropdown or tokenized selector | Comma-separated option values |
| Radio | Radio button group | The option value to select |
| Checkbox | Checkbox (single or group) | "true" or "false" (single), comma-separated values (group) |
| File | File upload input | Local file path to upload |
| Date | Date input or date picker | Date string (YYYY-MM-DD) |
| Number | Numeric input | Numeric string |
| Typeahead | Autocomplete / combobox | Text to type; use typeahead_selection for the option to click |
| Toggle | Toggle / switch control | "true" or "false" |
| RichText | Rich 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
}
| Property | Type | Required | Description |
|---|
field_id | string | ✅ | Field identifier from the fields array |
type | string | ✅ | Field type matching the discovered type |
value | string | ✅ | Value to set (format depends on type) |
selector | string | — | CSS selector (use the one from field discovery) |
clear_first | boolean | — | Clear field before typing (default: false) |
typeahead_selection | string | — | For Typeahead: the dropdown option text to click |
Typeahead Fields
Typeahead (autocomplete) fields require two values:
value — The text to type into the input (triggers the dropdown)
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.