# willo_contacts_write

> Change one of the business's contacts, or add one.

Generated from Willo's code at each release.

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

**Update a contact.** Name the person with `contact_id` (from willo_contacts), `email` or `phone`; an email or phone no contact has yet adds a new contact (with `name` and `company` if given). Then any of: `stage` (`new`, `talking`, `customer`, `lost`); a follow-up (`follow_up_at` as YYYY-MM-DD, which means 9:00 that day in the business's time zone, or an ISO date-time, plus `follow_up_note`) or `clear_follow_up` once they have been answered; `add_tags` / `remove_tags`; `fields`, free-form facts merged into what is kept (a key set to null is removed); a `note` added to their timeline; `archived` to hide or restore them. When someone has been replied to, set `stage` `talking` and `clear_follow_up`. Stage changes, new follow-up dates and notes appear on the contact's timeline as made by this token, and the contact records who last changed it. This sends nothing to the person: it only changes the business's records. 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 |
| --- | --- | --- | --- |
| `contact_id` | string | no | The contact to change. |
| `email` | string | no | Or: the person's exact email address. |
| `phone` | string | no | Or: the person's phone number. |
| `name` | string | no | Their name. |
| `company` | string | no | Their company. |
| `stage` | string (new or talking or customer or lost) | no | Their stage. |
| `follow_up_at` | string | no | When to follow up: YYYY-MM-DD or an ISO date-time. |
| `follow_up_note` | string | no | What the follow-up is about. |
| `clear_follow_up` | boolean | no | Remove the follow-up (they have been answered). |
| `add_tags` | string[] | no | Tags to add. |
| `remove_tags` | string[] | no | Tags to remove. |
| `fields` | object | no | Free-form facts to merge in; null removes a key. |
| `note` | string | no | A note for their timeline. |
| `archived` | boolean | no | true hides them from lists; false restores them. |

## 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)
