# willo_jobs_write

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

Generated from Willo's code at each release.

Source: https://www.willo.ai/docs/reference/mcp-tools/willo-jobs-write

**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. |

## Related

- [All MCP tools](https://www.willo.ai/docs/reference/mcp-tools)
- [Error codes](https://www.willo.ai/docs/reference/errors)
- [Draft and live](https://www.willo.ai/docs/ai-agents/draft-and-live)
