Send Leads from Zapier, Make or Your Forms
Create your lead webhook and connect Zapier, Make, a form builder or your own code, so every new lead shows up in CallTuv ready to call.
Updated
View as MarkdownDo you collect leads somewhere else - a form builder, an ad platform, your CRM, or your own website form? The lead webhook sends them straight into your CallTuv Leads list, so your team can call them the same way as requests from the website widget.
A webhook is simply a private web address. Your tool sends each new lead to that address, and CallTuv adds it to your list. You set it up once.
The webhook is free and works once your team has added calling credit. Only the team owner can create it and see its address. More in CallTuv for Business.
Step 1: Create your webhook and copy its URL
- Sign in at calltuv.com, click Business in the menu, then Integrations. (On a phone, Business opens with Leads, Widget and Integrations as tabs at the top.)
- Press Create webhook.
- Under Copy your webhook URL, press Copy URL.
Keep this URL private, like a password: anyone who has it can add leads to your list.
Step 2: Connect your tool
On the Integrations page, open Connect your tool and pick your tool's tab for these same steps.
Zapier
- In your Zap, after the step that gets the new lead (like a new form entry), add an action and choose Webhooks by Zapier.
- For Event, choose POST, then Continue.
- Paste your webhook URL into URL, and set Payload Type to JSON.
- Under Data, add a row for each field: phone on the left, and the phone answer from your form on the right. Do the same for name, email and message if you have them.
- Test the step. The lead shows up in Leads.
Webhooks by Zapier is on Zapier's paid plans, not the free one.
Make
- In your scenario, after the module that gets the new lead, add the HTTP app's Make a request module.
- Paste your webhook URL into URL, and set Method to POST.
- Set Body content type to application/x-www-form-urlencoded, and add the fields, mapping each one to your form's answer.
- Run the scenario once. The lead shows up in Leads.
A form builder
- In your form's settings, look for Webhooks. It is often under Integrations or Connect.
- Add a webhook, paste your webhook URL, and save.
- Make sure the form asks for a phone number. If you can name the field, call it phone.
- Fill in your form once. The lead shows up in Leads.
No webhook setting in your form? Most form builders connect to Zapier or Make, which can send it to CallTuv.
Your own code
Send a POST request to your webhook URL with JSON or form fields. No key or login is needed. The Your own code tab shows a ready example with your URL in it. A 201 answer means the lead was saved, and a 200 with "duplicate": true means it was already there.
The fields to send
Only the phone number is needed. Send the others when your form has them.
| Field | Name to use | What to put |
|---|---|---|
| Phone number (required) | phone (or phoneNumber, mobile, tel) |
With the country code, like +44 20 7946 0123. See Entering Phone Numbers. |
| Name | name |
Or first_name and last_name. |
email |
Their email address. | |
| Message | message (or comments, notes) |
Anything they wrote. |
| Source | source |
Where it came from, like "Typeform". Shown on the lead; without it, it says Webhook. |
| Lead ID | lead_id (or externalId, submission_id) |
Your tool's own id for the lead, so sending it twice never adds it twice. |
Names are matched loosely, so Phone, phone_number and Phone Number all work.
Step 3: Send a test lead
Fill in your form once, or run your Zap or scenario. The top of the Integrations page changes from "Waiting for your first lead" to Last lead with the person's name and number, and the lead appears in Leads.
Turn it off, or reset the URL
- Accept leads (the switch at the top) turns the webhook on or off. While it is off, leads your tools send are refused and not saved, so they never show up later, and your tool sees an error. Turn it back on to receive leads again.
- Reset URL gives you a new webhook URL. The old one stops working right away, so use this if the URL was shared by mistake. Then paste the new URL into every form and tool that sends you leads.
Limits that keep your list clean
- The same number is added only once every 15 minutes, so a form that fires twice does not make two leads.
- The webhook takes up to 120 leads a minute and 1,000 a day.
- Numbers in countries CallTuv does not call, and premium-rate numbers, are refused, with a message your tool can show.
Frequently asked questions
- How do I connect Zapier to CallTuv?
- In your Zap, after the step that gets the new lead, add an action and choose Webhooks by Zapier. Choose POST as the Event, paste your CallTuv webhook URL into URL, set Payload Type to JSON, and under Data add a row called phone with the phone answer from your form. Add name, email and message the same way if you have them, then test the step. Webhooks by Zapier is on Zapier's paid plans.
- How do I connect Make to CallTuv?
- In your scenario, after the module that gets the new lead, add the HTTP app's Make a request module. Paste your webhook URL into URL, set Method to POST, set Body content type to application/x-www-form-urlencoded, and add phone, plus name, email and message if you have them. Run the scenario once to test.
- What fields does the webhook need?
- Only the phone number, in a field called phone, with the country code, like +44 20 7946 0123. You can also send name (or first_name and last_name), email and message. Under More options there are source, the name shown on the lead, and lead_id, which stops the same lead being added twice.
- What happens to leads while the webhook is turned off?
- They are refused and not saved, so they never show up later. Your tool sees an error. Turn Accept leads back on to receive leads again.
- What if my webhook URL was shared by mistake?
- Press Reset URL and confirm. The old URL stops working right away, so anyone who had it can no longer send you leads. Paste the new URL into every form and tool that sends you leads.
- Is the lead webhook free?
- Yes. It costs nothing extra and works once your team has added calling credit. Calls you make to your leads are charged at the normal rates.
- Why aren't my leads showing up?
- Check that Accept leads is on, that your tool sends a POST to the exact webhook URL, and that the phone number is in a field called phone with its country code. Numbers in countries CallTuv does not call, and premium-rate numbers, are refused. Make sure your team has added credit.