Reference

willo_contact_sources_write

Link a backend table to Contacts, unlink one, or create or turn off a contact intake URL.

  • Act
  • Needs approval
  • Secret scan
Generated from Willo's codeOpen in ClaudeOpen in ChatGPT
On this page

Change where contacts come from. Pick one action and send only its arguments:

  • link_table (needs table, label, is_lead, mapping): every new row in table becomes a contact (matched by email, then phone) with an entry on their timeline, and the rows already there are added now, up to 2,000 per call (the result says when rows remain; link again to add them). Use it for a form built on a table of its own (quote requests, bookings, guide downloads). Read the table's columns with willo_db_schema first, then send label (what the timeline shows, like "Quote request"), is_lead (true when each row is someone owed a reply: they become new, due for a reply now, and the owner gets a lead alert; false for a list such as downloads) and mapping: the column holding the email and/or the phone (one is required), and any of the name (or first_name and last_name), message, company and created_at, plus fields for up to 20 other columns worth keeping. Linking a linked table again updates its mapping. It links the LIVE table: a table that exists only in the draft backend is linked after the owner publishes. Up to 25 linked tables per business.
  • unlink_table (needs table): table stops feeding Contacts. The contacts it added stay.
  • create_intake_url (needs label, is_lead; optional require_signature): a private URL a third-party tool (Zapier, Make, lead ads, a plain HTML form) posts people to, each becoming a contact. label names the tool ("Zapier: Facebook leads"), is_lead as above, require_signature to accept only signed calls. The URL is never returned to you, and you cannot read it anywhere: tell the person to open Contacts, press Connect a tool, then Show URL next to it, where the setup steps are. Show URL issues a new URL and the old one stops working, so use it only when setting a tool up or replacing a leaked URL. Up to 10 live URLs per business.
  • revoke_intake_url (needs id): id (from willo_contact_sources) turns that URL off for good; calls to it are refused from then on. The contacts it added stay. ALWAYS needs a person's approval: returns pending_approval with a dashboard link; call again with the same arguments after they approve. Needs owner or admin rank on the business. Free.

Access

  • Token: read + act, and editor access or higher on the business.
  • Approval: Always. Every call raises a card a person approves on the dashboard.
  • Secret scan: refused if the new content holds a value shaped like an API key or token.

Parameters

ParameterTypeRequiredDescription
actionstring (link_table or unlink_table or create_intake_url or revoke_intake_url)yesWhat to do.
tablestringnolink_table / unlink_table: the table's name, e.g. quote_requests.
labelstringnolink_table / create_intake_url: a short name for this source, e.g. "Quote request".
is_leadbooleannolink_table / create_intake_url: true when each person is a lead owed a reply; false for a list.
mappingobjectnolink_table: which of the table's columns holds what.
require_signaturebooleannocreate_intake_url: accept only signed calls (for developers).
idstringnorevoke_intake_url: the URL's id, from willo_contact_sources.