Reference

willo_contacts_write

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

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

ParameterTypeRequiredDescription
contact_idstringnoThe contact to change.
emailstringnoOr: the person's exact email address.
phonestringnoOr: the person's phone number.
namestringnoTheir name.
companystringnoTheir company.
stagestring (new or talking or customer or lost)noTheir stage.
follow_up_atstringnoWhen to follow up: YYYY-MM-DD or an ISO date-time.
follow_up_notestringnoWhat the follow-up is about.
clear_follow_upbooleannoRemove the follow-up (they have been answered).
add_tagsstring[]noTags to add.
remove_tagsstring[]noTags to remove.
fieldsobjectnoFree-form facts to merge in; null removes a key.
notestringnoA note for their timeline.
archivedbooleannotrue hides them from lists; false restores them.