willo_contacts_write
Change one of the business's contacts, or add one.
- Act
- May need approval
- Secret scan
On this page
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. |