assistant. invoice. approve
After approval, add a calendar payment reminder, create a Notion record, and generate a PDF receipt.
Charged by the tools it calls. Calendar event 5, notion.create_page 5, doc.render_pdf 25.
Example prompt
Send this to your AI app when Heelo is connected:
The invoice values are correct. Approve the run and add the payment reminder.
Input fields
| Field | Type | Description |
|---|---|---|
run_idRequired | string | The run id that start returned (inv_…). |
end_user_id | string | The end user the run was started for. |
review_digestRequired | string | The review_digest that status returned with the review. |
approved_byRequired | string | Who approves: the name of the person, or of the agent. |
corrections | object | Field name → corrected value: text, a number, or for line_items a list of rows. Typed and checked like extracted values (doc.review_decide); the checks run again, and the writes use the typed values. |
confirm | boolean | true writes; without it the answer says what would be written. |
Code
The call with the input fields that the tool needs. Replace each word in capitals, such as RUN_ID. Set HEELO_API_KEY to your API key.
import os
import requests
response = requests.post(
"https://toolsprimitives.uk/v1/tools/assistant.invoice.approve/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {
"run_id": "RUN_ID",
"review_digest": "REVIEW_DIGEST",
"approved_by": "APPROVED_BY",
}},
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/assistant.invoice.approve/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"run_id": "RUN_ID",
"review_digest": "REVIEW_DIGEST",
"approved_by": "APPROVED_BY"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());