Skip to main content

Integrating Thumbtack Leads with SmartMoving via Zapier

Send Thumbtack leads into SmartMoving automatically using Thumbtack's lead webhook, Zapier and the Custom Lead Provider, so new Thumbtack leads reach your pipeline with the customer's name and phone number.

Written by Michelle Carone

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.

  1. Go to Settings → Sales → Lead Providers. The list of lead providers opens.

  2. Find Custom Lead Provider and turn the toggle on. The toggle turns green and a dialog opens with connection instructions.

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

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

  1. Log in to Zapier and create a new Zap.

  2. For the Trigger, choose the app Webhooks by Zapier.

  3. Choose the event Catch Hook, then click Continue. Leave Pick off a Child Key blank.

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

  1. On a web browser, log in to your Thumbtack account.

  2. Select Apps at the top, then select Manage webhooks.

  3. If you have more than one business profile, choose the right profile from the drop-down menu.

  4. Select Create webhook.

  5. Paste your Zapier webhook URL from Step 2. Paste it exactly as copied; changing even one character breaks the connection.

  6. Choose leads as the data you want to receive. Leave messages and reviews unselected.

  7. Leave the authorization type as None.

  8. Click Create webhook.

  9. Open the webhook you just created and select Test this webhook. Thumbtack sends a sample lead tagged "test lead" to Zapier.

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

  1. Add a step and choose Webhooks by Zapier.

  2. For the Action Event, choose POST, then click Continue.

  3. In URL, paste your Custom Lead Provider URL from Step 1.

  4. Set Payload Type to Json. SmartMoving cannot read the default Form payload and returns "Unable to parse payload."

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

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

fullName

Required. A lead with no name is rejected.

Customer phone number

phoneNumber

Thumbtack includes a phone number on every lead.

City

originCity

State

originState

ZIP code

originZip

Requested date, if the request has one

moveDate

See the accepted formats in Key Details.

Job details (the customer's answers)

notes

Home size, distance and other answers are added to the lead's note.

(type in) Thumbtack

referralSource

Sets Thumbtack as the lead's referral source.

(type in) false

userOptIn

Thumbtack customers have not agreed to texts from you. Leaving this out counts as consent.

(optional, type in)

serviceType

For example Moving. See the accepted values below.

(optional, type in)

leadCost

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

fullName

The person's full name in one value. Used first if it has a value.

One name field is required

firstName, lastName

The name in two parts

One name field is required

email

Email address (Thumbtack does not provide one)

No

phoneNumber, extension

Phone number and extension

No

phoneType

Mobile, Home, Office or Other. Blank or unrecognized saves as Mobile.

No

userOptIn

true or false. Left out, the lead is saved as agreeing to text messages.

No

moveDate

Requested move date

No

originAddressFull, or originStreet, originCity, originState, originZip

Origin address, whole or in parts. If both are sent, the whole address is used.

No

destinationAddressFull, or destinationStreet, destinationCity, destinationState, destinationZip

Destination address, whole or in parts

No

moveSize

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

bedrooms

Number of bedrooms (added to the lead's note)

No

serviceType

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

opportunityType

Local, Intrastate or Interstate. Defaults to Local.

No

notes

Free text added to the lead's note

No

referralSource

The referral source shown on the lead

No

leadCost

What you paid for this lead. Overrides the Unit Cost on the Custom Lead Provider.

No

branchId

The branch the lead belongs to. Easiest to set with Choose Branch in Step 1.

No

utmSource, utmMedium, utmCampaign, utmAdGroup, utmContent, utmKeyword, utmCustomTracking

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

  1. Run the test on the Webhooks by Zapier step. Zapier posts the test lead to SmartMoving. A successful test shows a leadId in the response.

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

  3. 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 userOptIn is saved as agreeing to text messages. Send false for 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 new referralSource value 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 referralSource as Thumbtack in every Thumbtack Zap, so these leads separate cleanly from Yelp, Meta and website leads in your reports.

  • Send userOptIn as 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 fullName in 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 referralSource with 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.

Did this answer your question?