Overview
Connecting Thumbtack to SmartMoving through Zapier means every new Thumbtack lead arrives in SmartMoving as a lead, tagged with Thumbtack as the referral source, without anyone retyping it.
Thumbtack's webhook sends the details of each new lead, including the customer's name and phone number, to a web address you choose.
Zapier receives that lead with the Catch Hook trigger, then the Webhooks by Zapier action posts it to the address your SmartMoving Custom Lead Provider setting generates.
The connection is one way. You still reply to customers inside Thumbtack.
Thumbtack does not share customer email addresses, so Thumbtack leads arrive in SmartMoving without one.
Before You Start
Gather the following before you begin:
An admin role in SmartMoving. Enabling Custom Lead Provider requires access to Settings.
A paid Zapier plan (Professional or higher). Webhooks by Zapier is a premium app and is not available on the Free plan.
A Thumbtack Pro account you can log in to on a web browser. Thumbtack webhooks cannot be set up in the Thumbtack app.
If you have more than one Thumbtack business profile, plan one webhook per profile.
Step 1: Enable Custom Lead Provider in SmartMoving
The Custom Lead Provider setting generates the address that Zapier posts your Thumbtack leads to.
Go to Settings → Sales → Lead Providers. The list of lead providers opens.
Find Custom Lead Provider and turn the toggle on. The toggle turns green and a dialog opens with connection instructions.
If your company has more than one branch, choose the branch for these leads under Choose Branch. The URL in the dialog updates to include that branch. Leave it on Primary Branch to send leads to your primary branch.
Click the clipboard icon next to the URL in the dialog. The full posting URL copies to your clipboard. Save it for Step 4.
To reopen the dialog later, click View Instructions next to Custom Lead Provider. The copied URL looks like this, and ends in &branchId= and the branch ID when you chose a branch:
https://api.smartmoving.com/api/leads/from-provider/v2?providerKey={provider_key}💡 SmartTip: One Custom Lead Provider address can serve several lead sources at once, such as Thumbtack, Yelp and Meta. The referralSource field you send in each Zap keeps them apart in reporting.
Step 2: Create the Zap and Get Your Zapier Webhook URL
Zapier gives you the web address that Thumbtack sends leads to.
Log in to Zapier and create a new Zap.
For the Trigger, choose the app Webhooks by Zapier.
Choose the event Catch Hook, then click Continue. Leave Pick off a Child Key blank.
Copy the webhook URL Zapier shows. It looks like
https://hooks.zapier.com/hooks/catch/1234567/abcde/. Copy the whole address, including the letters and numbers at the end.
Leave this Zap open. You test the trigger after Thumbtack sends a test lead in Step 3.
Step 3: Create the Webhook in Thumbtack
The Thumbtack webhook sends each new lead to your Zapier webhook URL.
On a web browser, log in to your Thumbtack account.
Select Apps at the top, then select Manage webhooks.
If you have more than one business profile, choose the right profile from the drop-down menu.
Select Create webhook.
Paste your Zapier webhook URL from Step 2. Paste it exactly as copied; changing even one character breaks the connection.
Choose leads as the data you want to receive. Leave messages and reviews unselected.
Leave the authorization type as None.
Click Create webhook.
Open the webhook you just created and select Test this webhook. Thumbtack sends a sample lead tagged "test lead" to Zapier.
Return to Zapier and click Test trigger. The test lead appears, and its fields become available for the next step.
Note: Select leads only. If the webhook also sends messages or reviews, each one reaches the Zap and creates an unwanted lead in SmartMoving.
Step 4: Send the Lead to SmartMoving
This step posts each Thumbtack lead to your SmartMoving Custom Lead Provider URL.
Add a step and choose Webhooks by Zapier.
For the Action Event, choose POST, then click Continue.
In URL, paste your Custom Lead Provider URL from Step 1.
Set Payload Type to Json. SmartMoving cannot read the default Form payload and returns "Unable to parse payload."
Under Data, enter a SmartMoving field name on the left and select the matching value from the Thumbtack lead on the right. Use the mapping table below.
Leave Wrap Request In Array, File, Unflatten and Basic Auth at their defaults. Headers are optional; Json payload already sends
Content-Type: application/json.
Webhooks by Zapier settings at a glance
Setting | Value |
Action Event | POST |
URL | The URL copied from the Custom Lead Provider dialog |
Payload Type | Json |
Data | The fields in the mapping table below |
Wrap Request In Array, File, Unflatten, Basic Auth | Leave at default / blank |
Headers | Optional: Content-Type = application/json |
Mapping a Thumbtack lead
The Thumbtack field names appear in Zapier after the test lead in Step 3. Match them to SmartMoving fields as follows. Map only the values your lead contains.
Thumbtack lead value | SmartMoving field in Data | Notes |
Customer name |
| Required. A lead with no name is rejected. |
Customer phone number |
| Thumbtack includes a phone number on every lead. |
City |
| |
State |
| |
ZIP code |
| |
Requested date, if the request has one |
| See the accepted formats in Key Details. |
Job details (the customer's answers) |
| Home size, distance and other answers are added to the lead's note. |
(type in) Thumbtack |
| Sets Thumbtack as the lead's referral source. |
(type in) false |
| Thumbtack customers have not agreed to texts from you. Leaving this out counts as consent. |
(optional, type in) |
| For example Moving. See the accepted values below. |
(optional, type in) |
| What you pay Thumbtack per lead, as a number such as 25. |
All SmartMoving field names for the Data section
These are every field the SmartMoving Lead API accepts. Field names are not case-sensitive.
SmartMoving field | What it holds | Required |
| The person's full name in one value. Used first if it has a value. | One name field is required |
| The name in two parts | One name field is required |
| Email address (Thumbtack does not provide one) | No |
| Phone number and extension | No |
| Mobile, Home, Office or Other. Blank or unrecognized saves as Mobile. | No |
| true or false. Left out, the lead is saved as agreeing to text messages. | No |
| Requested move date | No |
| Origin address, whole or in parts. If both are sent, the whole address is used. | No |
| Destination address, whole or in parts | No |
| The exact name of a Move Size in Settings → Estimates → Move & Room Sizes. A name that does not match creates a new Move Size. | No |
| Number of bedrooms (added to the lead's note) | No |
| Moving, Packing, MovingAndPacking, LoadOnly, UnloadOnly, Commercial, StorageInBound, StorageOutBound, InnerHouse, JunkRemoval or LaborOnly, spelled exactly as shown, or the name of a service type you created | No |
| Local, Intrastate or Interstate. Defaults to Local. | No |
| Free text added to the lead's note | No |
| The referral source shown on the lead | No |
| What you paid for this lead. Overrides the Unit Cost on the Custom Lead Provider. | No |
| The branch the lead belongs to. Easiest to set with Choose Branch in Step 1. | No |
| Marketing tracking values | No |
Any other field name is accepted and added to the lead's note. If the name matches one of your Custom Information Fields (Settings → Estimates → Custom Information Fields), the value also fills that field.
Step 5: Test the Zap and Turn It On
Run the test on the Webhooks by Zapier step. Zapier posts the test lead to SmartMoving. A successful test shows a
leadIdin the response.Log in to SmartMoving and find the lead in your pipeline. Confirm the name, phone number, location, job details and referral source arrived as you expect. Delete the test lead when you are done.
Turn the Zap on. New Thumbtack leads flow into SmartMoving from this point forward.
Note: SmartMoving permanently rejects an exact repeat of a lead it already accepted. To test again, send a new test lead from Thumbtack rather than re-running the same one.
Key Details
Thumbtack has no app in the Zapier app directory. The connection uses Thumbtack's own webhook with Zapier's Catch Hook trigger.
The connection is one way. Reply to Thumbtack customers in Thumbtack. Their replies do not reach SmartMoving.
No email addresses. Thumbtack does not share customer emails, so email automations cannot reach these leads until you add an email to the lead.
New-lead automations run. Thumbtack leads trigger the same new-lead automations as any other lead.
Text consent defaults to yes. A lead sent without
userOptInis saved as agreeing to text messages. Sendfalsefor Thumbtack leads.One webhook per business profile. If you have several Thumbtack profiles, create a webhook for each. To send each profile's leads to a different branch, use a separate Zap per profile with that branch's Custom Lead Provider URL.
Referral source defaults to Custom Lead Provider. Without
referralSource, the lead shows "Custom Lead Provider". The first lead carrying a newreferralSourcevalue adds it to Settings → Sales → Referral Sources.Move date formats. MM/DD/YYYY, MM-DD-YYYY, YYYY/MM/DD, YYYY-MM-DD and YYYYMMDD work reliably, as do most other common date formats. A value SmartMoving cannot read leaves the move date blank, and the raw value appears in the lead's note on a line reading "Move date:".
Unrecognized values do not block the lead. An unknown service type or branch ID is noted on the lead ("Unsupported service type:" or "Unknown branch ID:"), and a lead with no branch, or an unknown one, goes to your primary branch.
Duplicate rejection is permanent. SmartMoving compares the provider key, the branch and every value sent. A customer who submits a second, different request in Thumbtack creates a second lead.
Best Practices
Select leads only on the Thumbtack webhook, so messages and reviews never become leads.
Send
referralSourceas Thumbtack in every Thumbtack Zap, so these leads separate cleanly from Yelp, Meta and website leads in your reports.Send
userOptInas false, because Thumbtack customers have not agreed to texts from you.Keep Thumbtack's own lead notifications on as a backup, so a paused Zap never costs you a lead.
Check the Zap history in Zapier and the Recent deliveries tab in Thumbtack during the first few weeks.
Troubleshooting
Thumbtack's Recent deliveries shows a "Failure" status.
The Zapier webhook URL in Thumbtack is incomplete or was edited. Copy the URL from the Catch Hook step again, including the letters and numbers at the end, paste it into the Thumbtack webhook, and send another test lead. Toggling the webhook off and back on can also reset the connection.
Thumbtack shows a successful delivery, but no lead appears in SmartMoving.
The lead reached Zapier but did not reach SmartMoving. Open the Zap's history in Zapier to see the error on the Webhooks by Zapier step. Make sure the Zap is turned on.
Zapier shows a 400 error saying "Unable to parse payload."
Payload Type is not set to Json. Set it to Json in the Webhooks by Zapier step and test again.
Zapier shows a 400 error saying "At least one name field is required."
The customer name is not mapped. Map the Thumbtack customer name to
fullNamein the Data section.
Zapier shows a 400 error saying the lead has already been submitted.
SmartMoving rejects an exact repeat of a lead it already accepted. The full message reads "This lead has already been submitted. Please contact SmartMoving support." Send a new test lead from Thumbtack.
Zapier returns an error saying the provider is disabled.
The Custom Lead Provider toggle in Settings → Sales → Lead Providers has been turned off. Turn it back on.
Leads are appearing for Thumbtack messages or reviews.
The webhook is sending more than leads. In Thumbtack, open Apps → Manage webhooks, select the webhook, choose leads only, and select Save changes. Delete the unwanted leads in SmartMoving.
Thumbtack leads show a referral source of Custom Lead Provider.
Add
referralSourcewith the value Thumbtack to the Data section. Leads already in SmartMoving keep the old source and need updating by hand.
Thumbtack leads land at the wrong branch.
Leads with no branch go to your primary branch. Choose the branch under Choose Branch in the Custom Lead Provider dialog, copy the new URL, and paste it into the Webhooks by Zapier step.



