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
On this page
Change where contacts come from. Pick one action and send only its arguments:
link_table(needstable,label,is_lead,mapping): every new row intablebecomes 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 sendlabel(what the timeline shows, like "Quote request"),is_lead(true when each row is someone owed a reply: they becomenew, due for a reply now, and the owner gets a lead alert; false for a list such as downloads) andmapping: 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, plusfieldsfor 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(needstable):tablestops feeding Contacts. The contacts it added stay.create_intake_url(needslabel,is_lead; optionalrequire_signature): a private URL a third-party tool (Zapier, Make, lead ads, a plain HTML form) posts people to, each becoming a contact.labelnames the tool ("Zapier: Facebook leads"),is_leadas above,require_signatureto 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(needsid):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: returnspending_approvalwith 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
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string (link_table or unlink_table or create_intake_url or revoke_intake_url) | yes | What to do. |
table | string | no | link_table / unlink_table: the table's name, e.g. quote_requests. |
label | string | no | link_table / create_intake_url: a short name for this source, e.g. "Quote request". |
is_lead | boolean | no | link_table / create_intake_url: true when each person is a lead owed a reply; false for a list. |
mapping | object | no | link_table: which of the table's columns holds what. |
require_signature | boolean | no | create_intake_url: accept only signed calls (for developers). |
id | string | no | revoke_intake_url: the URL's id, from willo_contact_sources. |