Reference

willo_jobs_write

Add a job to one of the business's contacts, or change one.

  • Act
  • May need approval
  • Secret scan
Generated from Willo's codeOpen in ClaudeOpen in ChatGPT
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

ParameterTypeRequiredDescription
job_idstringnoThe job to change.
contact_idstringnoTo add: the contact the job is for.
titlestringnoThe job's short name.
stagestring (requested or quoted or won or lost)noThe job's stage.
valuenumber ≥ 0noThe job's value, like 4200.
currencystringnoLike usd.
expected_onstringnoWhen it should close, YYYY-MM-DD.
notesstringnoNotes on the job.
lost_reasonstringnoWhy it was lost.