Overview

You can send leads from your own website form straight into Supermove, either from your website directly or through a tool like Zapier (Webhooks by Zapier). Each submission creates a new project in Supermove. This article is a step-by-step setup guide you can share with your web developer or marketing agency.

No developer? Supermove Lead Forms are the no-code option: build a form in Supermove and link to it or embed it on your website.

In this article, you'll learn how to:

• Choose the right endpoint
• Create your endpoint URL in Supermove
• Set up a Zapier webhook
• Track lead source, UTM values, and ad click IDs
• Test safely and fix common problems

Step 1: Choose an Endpoint

If you need the UTM campaign, referrer URL, or several marketing touchpoints stored with each lead, use the Developer API. See UTM Tracking in Supermove for what each option supports.

Step 2: Create Your Endpoint URL

1. Go to Settings → Company Settings → Lead Providers.
2. Click + Add Lead Provider.
3. Select Standard Website or Developer API.
4. Add a Name and Description (for example, "Website quote form via Zapier").
5. Click Copy URL.

Note: The URL is unique to your Supermove account. No API key or organization ID is needed. Treat the URL like a password and share it only with the person building your integration. You can create more than one endpoint, for example one per form.

Step 3: Set Up the Zapier Webhook

1. In Zapier, set your form tool (for example, your website form plugin) as the trigger.
2. Add an action step: Webhooks by Zapier → POST.
3. Paste your Supermove endpoint URL as the URL.
4. Set Payload Type to JSON, so the request is sent with Content-Type: application/json.
5. Map your form fields to the Supermove fields (see Step 4).
6. Make sure the Zap has only one step that sends to Supermove. Every request Supermove receives creates a project.

Step 4: Map Your Form Fields

For the Developer API, the payload must include:

• project_type and each job's job_type, using the identifiers from your account. See Accessing Your Project And Job Type Identifiers.
• client.name and client.primary_contact.full_name (combine first and last name if your form collects them separately)
• At least one job with at least one location that has an address

Formats Supermove expects:

Step 5: Track Lead Source and Ads

• Lead source: send "referral_source": "Google Ads - Website Form". This fills the project's How Did You Hear About Us? field. We recommend adding the same value to your referral sources in Supermove first so it matches your reports.
• UTM and click IDs: add a milestones entry with "kind": "LEAD_CREATED", a timestamp in ISO-8601 UTC format, and any of utm_source, utm_medium, utm_campaign, utm_term, utm_content, referrer_url. For a Google Ads click ID (GCLID), send "ad_kind": "GOOGLE_ADS" and "ad_click_id". Use "FACEBOOK" for Facebook ads. Any other ad_kind value is rejected.
• Reporting: use the Revenue by Referral Source report, filtered by your referral source and a status of Booked, to see booked projects and revenue from your form. See also UTM Tracking in Supermove.

Step 6: Test Safely

1. Add "is_test": true to your test payloads (Developer API).
2. Submit a test from your form.
3. In Settings → Company Settings → Lead Providers, open your endpoint and go to the Logs tab.
4. Open the request and review the Request Body (what was sent) and the response (whether Supermove accepted it and why not, if it didn't).
5. Remove is_test (or set it to false) when you go live.

Troubleshooting

For more, see Debugging Inbound Leads.

⚠️ Important Notes

• Every request sent to the endpoint creates a lead, so repeat submissions from the same customer may create separate projects. Use a filter in Zapier if you want to block repeats.
• To alert your office when a lead arrives, set up an automation with the New project created trigger that creates a task or sends an internal email. See Create Tasks & Send Welcome Email to New Lead.
• Your account owner or an admin needs to create the endpoint in Supermove and share the URL with your developer or agency.

Need Help?

Reply to your support conversation, or email help@supermove.com. If you'd like a Product Expert to review your setup, include:

• Which endpoint you're using (Standard Website or Developer API) and its name in Lead Providers
• The tool sending the leads (for example, Zapier, or your website form)
• The project type and job type new leads should use
• The referral source value you want to send
• The time of a test submission, so we can find it in the logs
• The contact details of your developer or agency, if they should be included