web. fill_ form
Fill out a web form, show a preview, and submit it after confirmation.
40 credits. Per form sent. 0 when cancelled.
Example prompt
Send this to your AI app when Heelo is connected:
Fill out the contact form at https://example.com/contact with my details
Input fields
| Field | Type | Description |
|---|---|---|
url | string | The page containing the form to fill |
data | object | Field hints, e.g. {'email': '[email protected]'} |
instructions | string | Free-text guidance for filling the form |
files | object | Field hint -> file to upload, given as an https URL (preferred; fetched securely) or a sandbox-relative path. E.g. {'resume': 'https://.../cv.pdf'} |
auto_submit | boolean | Submit without the review-and-confirm gate |
query | string | NL-router free text (a URL is extracted from it) |
end_user_id | string | |
session_id | string | |
message | string |
Output fields
The fields in data when status is success.
| Field | Type |
|---|---|
submitted | boolean |
status | string |
summary | array of object |
message | string |
Code
The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.
import os
import requests
response = requests.post(
"https://toolsprimitives.uk/v1/tools/web.fill_form/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {
"url": "https://example.com/contact",
}},
timeout=120,
)
response.raise_for_status()
print(response.json())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/web.fill_form/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"url": "https://example.com/contact"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());