# 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.

Last updated: November 17, 2026

Source: https://www.willo.ai/docs/business-records/connect-tools-to-contacts

Your contact form, waitlist, email list and sales already feed [Contacts](https://www.willo.ai/docs/business-records/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**.

1. Open **Contacts** and press **Connect a tool**.
2. Name the URL after the tool ("Zapier: Facebook leads"), and tick **Each person is a lead** if they need a reply.
3. Press **Create URL** and copy it. Willo shows it once.
4. 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:

```json
{"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-Key` header 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 `attribution` object with any of `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`, `landing_page`, `referrer` and `click_id` (strings, up to 300 characters each), or the same keys at the top level. `referrer` is the site that sent them (`www.google.com/search` or a full URL); `click_id` is the ad network's name (`google`, `facebook`, `microsoft`). A raw `gclid`, `fbclid` or `msclkid` is 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 inside `attribution` are ignored.
- **Leads**: a signed call may send `"lead": true` to make a person a lead on a list URL. Unsigned calls can only send `"lead": false`.
- **Errors**: `401` wrong URL or signature, `404` unknown or turned-off URL, `409` this business's contacts aren't set up (open the Contacts page once), `413` body too large, `415` not JSON or form fields, `422` no email or phone, `429` too many calls (honour `Retry-After`), `503` try again shortly.

Per-minute and per-day limits are in the [limits reference](https://www.willo.ai/docs/reference/limits).

## From an outside agent

An agent connected to your business can list linked tables and intake URLs with [willo_contact_sources](https://www.willo.ai/docs/reference/mcp-tools/willo-contact-sources), and link or unlink a table or create or turn off an intake URL with [willo_contact_sources_write](https://www.willo.ai/docs/reference/mcp-tools/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](https://www.willo.ai/docs/ai-agents/agent-tokens#change-the-scope). See [give an agent access](https://www.willo.ai/docs/site/give-an-agent-read-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.
