Connect forms and other tools to Contacts
Send people from Zapier, Make, lead ads, booking tools, an HTML form or a form Willo built into your contacts, with a lead alert when they need a reply.
On this page
- Link a form Willo built
- Connect Zapier, Make or another tool
- Zapier
- Make
- Typeform and Calendly
- Jotform and lead ads
- A plain HTML form
- Lead magnets on your Willo site
- For developers
- From an outside agent
- Questions
- Does connecting a tool put people on my email list?
- What if my tool sends the same person twice?
- Someone got hold of my URL. What do I do?
Your contact form, waitlist, email list and sales already feed Contacts. This page covers everything else: forms Willo built on tables of their own, and tools outside Willo. Only the business's owner and admins can connect them.
Link a form Willo built
When Willo builds a form that saves to its own table (quote requests, bookings, guide downloads), ask Willo to link it:
Link my quote requests to Contacts.
Willo reads the table, proposes which column is the email, phone, name, message and company, and which other columns to keep (job type, budget, address). It also asks whether each row is a lead or just someone on your list:
- Lead: the person shows as New and waiting on you, and you get a lead alert, the same as your contact form.
- On your list: the person is added with no stage and never waits on you. Use this for downloads and signups.
You approve the link on a card. Willo then adds the people already in the table, and everyone who arrives after that. Linking never slows down or blocks the form: if anything goes wrong, the visitor's form still saves.
If the table is deleted and made again with the same name, Willo links it again when you open Connect a tool or ask which forms feed your contacts, and adds the people already in it.
To stop, ask Willo to unlink the table. The contacts it already added stay. "Which forms feed my contacts?" lists every linked table and intake URL.
Connect Zapier, Make or another tool
Other tools send people to Contacts through a private intake URL.
- Open Contacts and press Connect a tool.
- Name the URL after the tool ("Zapier: Facebook leads"), and tick Each person is a lead if they need a reply.
- Press Create URL and copy it. Willo shows it once.
- Follow the steps under the URL for your tool.
You can also ask Willo in chat to create one. Willo never shows the URL in chat: copy it from the Contacts page with Show URL. Show URL issues a new URL and the old one stops working, so paste the new one into your tool.
Zapier
Add the action Webhooks by Zapier → POST after your trigger. Paste the URL, set Payload Type to json, and map these fields under Data:
| Field | What to send |
|---|---|
email | The person's email address. |
phone | Their phone number. |
name, or first_name and last_name | Their name. |
message | What they asked. |
company | Their company. |
source | Optional: where they came from, shown on the timeline. Defaults to the URL's name. |
lead | Optional: false to add this person to your list on a lead URL. Whether a person is a lead is set on the URL, so make one URL for leads and one for your list. |
Send an email or a phone number: a call with neither is refused. Common spellings work too (Email, E-mail, email_address, Phone Number, Comments). Anything else you send, up to 20 fields, is kept on the contact.
Make
Add HTTP → Make a request. Paste the URL, set Method to POST, Body type to Raw and Content type to JSON, and send the same fields:
{"email": "maria@example.com", "name": "Maria Lopez", "phone": "555 123 4567", "message": "Sauna quote, please"}Typeform and Calendly
Paste the intake URL straight into the tool, no Zapier needed:
- Typeform: open the form, go to Connect → Webhooks, add the URL and turn it on. The email and phone answers become the person's, long-text answers become their message, and every other answer is kept under its question, up to 20.
- Calendly: create a webhook subscription for invitee.created with the URL. The invitee's name, email and text-reminder number are kept, the booking questions' answers become the message and are kept under each question, and the booking link's
utm_values are kept as where they came from. Cancellations and other Calendly events are ignored.
Both tools sign their calls their own way, which Willo doesn't check. For a URL created with signing on, connect them through Zapier or Make instead.
Jotform and lead ads
Connect them through Zapier or Make with the steps above. Facebook lead ads' own field list (field_data) is read as it comes.
A plain HTML form
For a form on a site Willo doesn't build, Connect a tool gives you a copy-paste form. It posts form fields (application/x-www-form-urlencoded) to the URL. Anyone who views the page can see the URL, so give that form a URL of its own.
Lead magnets on your Willo site
For a download or signup form on your Willo site, ask Willo to give it a name of its own, such as "pricing guide". Each signup becomes a contact with that name as its source, and the person joins your email list as a normal signup.
For developers
Every call is a POST with a JSON or form body. Willo answers 200 with {"status": "added"} or {"status": "duplicate"}, or {"status": "ignored"} for a Typeform or Calendly event that isn't a finished response or a new booking.
- Idempotency: send an
Idempotency-Keyheader to make retries safe. Without one, the same body on the same day counts once. - Signature (optional, required when you create the URL with signing on):
X-Willo-Signature: t=<unix seconds>,v1=<hex>, where the hex is HMAC-SHA256 of<t>.<raw body>keyed with the URL's last path segment. Willo accepts a timestamp within five minutes, so a captured call can't be replayed later. The key is part of the URL: keep a signed URL out of public pages. - Where they came from: send an
attributionobject with any ofutm_source,utm_medium,utm_campaign,utm_term,utm_content,landing_page,referrerandclick_id(strings, up to 300 characters each), or the same keys at the top level.referreris the site that sent them (www.google.com/searchor a full URL);click_idis the ad network's name (google,facebook,microsoft). A rawgclid,fbclidormsclkidis read as that network and the id itself is not kept. Willo keeps it as where they first found you when the call adds a new contact, and never as a custom field. Other keys insideattributionare ignored. - Leads: a signed call may send
"lead": trueto make a person a lead on a list URL. Unsigned calls can only send"lead": false. - Errors:
401wrong URL or signature,404unknown or turned-off URL,409this business's contacts aren't set up (open the Contacts page once),413body too large,415not JSON or form fields,422no email or phone,429too many calls (honourRetry-After),503try again shortly.
Per-minute and per-day limits are in the limits reference.
From an outside agent
An agent connected to your business can list linked tables and intake URLs with willo_contact_sources, and link or unlink a table or create or turn off an intake URL with willo_contact_sources_write. Every change waits for a person to approve it. An agent never sees an intake URL: copy it from the Contacts page with Show URL. 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. Both tools need a connection made by an owner or admin, and the write tool needs one switched to Read + act. See give an agent access.
Questions
Does connecting a tool put people on my email list?
Leads a tool sends with an email join your email list, just like leads from your own forms, unless you turn that off in Contacts settings. Contacts a tool sends without marking them as leads don't. Anyone who unsubscribed stays off.
What if my tool sends the same person twice?
Willo matches people by email, then phone, so they stay one contact with two entries on their timeline. A repeated call with the same Idempotency-Key, or the same body on the same day, is recorded once.
Someone got hold of my URL. What do I do?
On the Contacts page, press Connect a tool and Turn off next to it, or Show URL to replace it with a new one. The old URL stops working at once.