🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!
Guides & Tutorials October 10, 2026

Workiz Website Form Integration: Turn WordPress Service Requests Into Leads

GravityExtra
Workiz Website Form Integration: Turn WordPress Service Requests Into Leads

A homeowner with a leaking water heater or a broken garage door does not wait long. They fill in the service request form on two or three websites, and the company that calls back first usually gets the job. If your team runs on Workiz, every minute between that form submission and a lead in Workiz is a minute your dispatcher cannot act.

This guide is for plumbing, HVAC, electrical, locksmith, garage door, cleaning and other home service businesses whose website runs on WordPress. It compares the ways to connect a website form to Workiz and shows how to send each Gravity Forms service request straight into Workiz as a lead, with the requested appointment time, service address, job type and an assigned technician.

Why Website Service Requests Get Stuck

Common gaps between the website and Workiz
1. Inbox forms: the request arrives by email and someone re-enters it in Workiz between phone calls, often hours later.
2. Wrong appointment times: a “Tuesday at 2 PM” request typed in by hand, or passed through without a timezone, can land at the wrong hour on the schedule.
3. Nobody owns the lead: the request sits unassigned until a dispatcher notices it.
4. Lost attribution: without a job source, you cannot see which marketing channel actually brings in work.

Your Options for a Workiz Website Form Integration

There are three common ways to get website requests into Workiz:

  • Workiz’s built-in service form. Under Settings → Integrations → Website Integration you can build forms, choose required fields, set email or SMS alerts, auto-assign and turn on CAPTCHA, then link to the hosted form or paste its embed code on your site. It is the quickest start, but the form is built and styled inside Workiz, not in WordPress.
  • Zapier. Workiz has a Zapier app with a Create Lead action, and Gravity Forms can trigger it. That route needs a Zapier subscription and the Gravity Forms Zapier add-on, which is included with the Pro, Elite and Nonprofit licenses. Field formatting and failure alerts depend on how the Zap is built.
  • A direct API connection from Gravity Forms. This is what the GravityExtra add-on does, using the Workiz Developer API.

What the Workiz Add-on for Gravity Forms Does

The Gravity Forms Workiz Premium Add-on sends each submission from your Gravity Forms service request form to Workiz as a new lead the moment it is submitted. It maps:

  • Client: first and last name (or one full name field, split automatically), company, email, phone, extension and a second phone.
  • Service address: street, unit, city, state, ZIP and country from a Gravity Forms Address field. US state names such as “Texas” become two-letter codes like TX.
  • Requested time: the date and start time from your form (plus an optional end time), read in the timezone you choose and sent to Workiz in the standard format it expects. If the form asks only for a date, a default start time is used.
  • Job details: job type, job source (default Website), referral company and service area, as fixed text or filled from the visitor’s answers with merge tags.
  • Notes: the customer’s message plus any extra fields, such as “Equipment age” or “Gate code”, each added to the lead notes as a labeled line.
  • Assignment: optionally assign every new lead to a team member picked from your active Workiz team.

Every entry shows its Workiz delivery status, and failed leads are emailed to a backup address so a request is never silently lost.

How to Connect Gravity Forms to Workiz (Step by Step)

You need WordPress 6.5 or later, Gravity Forms 2.5 or later (any license) and the Workiz Developer API add-on on your Workiz account.

Step 1: Generate your Workiz API credentials

In Workiz, open Feature Center → Add-ons → Developer API and click Generate API credentials. Afterwards, the API token and API secret are available under Settings → Integrations → Developer.

Step 2: Connect and test in WordPress

Activate the add-on, enter your GravityExtra license key, and open Forms → Settings → Workiz. Paste the token and secret (both are stored in masked fields) and save. The add-on reads your Workiz team list to confirm the token and shows how many active team members it found. Add a backup email for failed leads.

Workiz Developer API settings connected with API token, API secret and backup email in Gravity Forms
A successful connection, with the Test connection button and backup email.

Workiz checks the API secret only when a lead is created, so finish by submitting one sample service request and confirming the lead appears in Workiz.

Step 3: Map the client, address and requested time

Open your service request form, go to Settings → Workiz and click Add New. Map the client fields and the parts of your Address field. Then map a Date field and a Time field for the requested appointment and choose the timezone your customers book in.

Workiz feed requested time mapping with date, start time, default start time and timezone
Requested time read in the America/Chicago timezone, with a default start time.

Step 4: Set job details and auto-assign

Fill in Job Type from the visitor’s choice with a merge tag such as {Service Needed:8}, keep Job Source as Website (or your own value), map the message and any extra fields, and pick a technician or dispatcher in Assign to Team Member. Values should match the job types, sources and service areas set up in Workiz.

Workiz feed Job Details with job type merge tag, job source, lead notes, extra fields, team member assignment and conditional logic
Job type from the Service Needed field, an extra field, and automatic assignment.

Step 5: Check delivery on the entry

After a successful send, the entry’s Workiz box shows Lead sent, the Workiz lead ID and an Open lead in Workiz link, and the entry notes record the send and the assignment.

Workiz status box on a Gravity Forms entry showing Lead sent, the Workiz lead UUID and an Open lead in Workiz link
One click from the entry to the lead in Workiz.

The Workiz add-on setup guide covers every field and troubleshooting step.

When a Request Does Not Reach Workiz

If Workiz cannot be reached or rejects a lead, the entry is kept, its status becomes Not delivered, a note records the reason, and the backup email sends your team the client, address, requested time and notes. Fix the cause and click Send to Workiz again. Because Workiz creates a new lead for every request, the add-on asks for confirmation before resending an entry that was already delivered. If only the assignment fails, the lead stays in Workiz and the entry gets a warning note. Your API token and secret never appear in notes, logs or emails.

Example: A Service Request Form for an HVAC Company

Form field Gravity Forms field type In Workiz
Name, email, phone Name, Email, Phone Client details
Service address Address Lead address, state as a 2-letter code
Service needed Drop Down (AC repair, furnace tune-up…) Job type (via merge tag)
Preferred date and time Date, Time Requested start time
System age, gate code Drop Down, Single Line Text Lead notes (Extra Fields)
Describe the problem Paragraph Lead notes (message)
How did you hear about us? Drop Down Job source (via merge tag)

Practical feed setups

  • Route by trade: create two feeds that assign different team members, with conditional logic on the Service Needed field, so plumbing requests go to one dispatcher and HVAC to another.
  • Skip existing customers: if “Are you an existing customer?” is Yes, do not create a new lead and let the office handle it.
  • Only services you offer in Workiz: send a lead only when the selected service matches a Workiz job type.

If you charge trip fees, the Distance & Location Pricing add-on calculates driving distance with Google Maps, adds zone surcharges and can block addresses outside your service area. And the Abandoned Form Recovery add-on saves partially completed requests and emails a resume link.

Workiz Integration Methods Compared

What matters Workiz add-on Workiz service form Zapier Manual entry
Form built in Gravity Forms Workiz Gravity Forms Any
Gravity Forms license Any license Not used Pro, Elite or Nonprofit Any
Requested time and timezone Converted for you Handled by Workiz Depends on your Zap By hand
Auto-assign Yes, per feed Yes Depends on your Zap By hand
Failed delivery Backup email, status, resend Handled by Workiz Depends on your Zap Depends on staff
Extra cost From $39 per year + Workiz Developer API Included Zapier subscription Staff hours

If the Workiz form fits your website, it is the simplest choice. If your site already uses Gravity Forms, or you want multi-step forms, conditional logic and your own design, a direct connection keeps everything in WordPress without an extra automation tool in the middle.

Recommended for home service businesses on WordPress

Keep your Gravity Forms service request form and let the Gravity Forms Workiz Premium Add-on create an assigned Workiz lead with the right appointment time. Licenses are $39 for 1 site, $69 for 5 sites or $149 for 10 sites per year.

Frequently Asked Questions

Do I need the Workiz Developer API add-on?

Yes. The add-on connects through the Workiz Developer API, which is a paid add-on in Workiz. Generate the token and secret under Feature Center → Add-ons → Developer API.

Will the appointment time show up correctly in Workiz?

Yes, as long as the feed timezone matches the timezone your customers book in. The add-on reads the form’s date and time in that timezone and converts it before sending. An end time earlier than the start is ignored.

Can new leads be assigned to a technician automatically?

Yes. Pick a team member in the feed. Use several feeds with conditional logic to assign different people by service or area. If assignment fails, the lead is still created and the entry gets a note.

Can I track which marketing channel a request came from?

Yes. Set Job Source to a fixed value or fill it from a “How did you hear about us?” field with a merge tag. Hidden fields with campaign data can be added to the lead notes as extra fields.

Does it record SMS or marketing consent?

There is no dedicated consent setting. Map your consent checkbox as an extra field, for example labeled “SMS consent”, so your team sees the answer in the Workiz lead notes.

Send every service request to Workiz

Client, address, requested time and job type mapped from your form, plus auto-assignment and a backup email for failed leads.

Get the Workiz Add-on →

Want to see every setting first? Read the setup guide

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr