Reference
willo_jobs_write
Add a job to one of the business's contacts, or change one.
- Act
- May need approval
- Secret scan
On this page
Add or change a job. To add: contact_id (from willo_contacts) and title ("Bathroom refit"), plus any of value (an amount in the currency's main unit, like 4200), currency (three letters, like usd), expected_on (YYYY-MM-DD), notes and stage (default requested). To change: job_id (from willo_jobs) plus any of title, stage, value, currency, expected_on, notes, lost_reason. A won job makes the person a customer; an open job moves a new contact to talking. Each change is on the person's timeline as made by this token. This sends nothing: a quote is emailed from the Contacts page, where the owner presses Send. Needs owner or admin rank on the business. No card. Free.
Access
- Token: read + act, and editor access or higher on the business.
- Approval: Only when Willo's chat would stop for the same action. The description says when; otherwise the call runs at once.
- Secret scan: refused if the new content holds a value shaped like an API key or token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
job_id | string | no | The job to change. |
contact_id | string | no | To add: the contact the job is for. |
title | string | no | The job's short name. |
stage | string (requested or quoted or won or lost) | no | The job's stage. |
value | number ≥ 0 | no | The job's value, like 4200. |
currency | string | no | Like usd. |
expected_on | string | no | When it should close, YYYY-MM-DD. |
notes | string | no | Notes on the job. |
lost_reason | string | no | Why it was lost. |