WordPress to Zoho People Integration
FormBridge for Zoho Pro
A WordPress to Zoho People integration sends each form submission to Zoho People automatically, creating employees, onboarding candidates, leave requests or records in your own HR forms without manual entry or code.
This guide shows how to set up the Zoho People destination in FormBridge for Zoho: choose your account and the app, pick a module, test the connection, handle duplicates, map your form fields, add optional conditional logic, then test and save the feed.
The Zoho People destination is part of FormBridge for Zoho Pro. See how to install Pro and activate your licence.
Supported form plugins and Zoho apps
FormBridge for Zoho connects these WordPress form plugins with your Zoho apps. This guide covers the Zoho People destination.
WordPress form plugins
- Elementor Forms
- Contact Form 7
- WPForms
- Gravity Forms
- Fluent Forms
- Ninja Forms
- Forminator Forms
- Formidable Forms
- Happyforms
- SureForms
Zoho apps
- Zoho CRM
- Zoho Books
- Zoho Desk
- Zoho Bigin
- Zoho Campaigns
- Zoho Marketing Automation
- Zoho Inventory
- Zoho FSM
- Zoho People
Before you start
- FormBridge for Zoho Pro is installed and your licence is active.
- Your WordPress form is published and its trigger is set up in FormBridge for Zoho.
- Your Zoho account is authorised for Zoho People under FormBridge for Zoho → Connections. If it isn’t, follow the guide to creating a Zoho connection.
- You know which module should receive the data, and your form collects that module’s required fields.
How to set up a WordPress to Zoho People integration
Once your form trigger and feed details are ready, follow these eight steps.
Step 1: Select your account
Destination › AccountOn the Destination step, open the Account dropdown and choose the Zoho account you authorised under FormBridge for Zoho → Connections. Records are created in this account.
No account in the list?Use Connect account at the top of the panel, or create the connection first and return to the feed. Learn how to create a Zoho connection.
Choosing the connected Zoho account. Step 2: Select Zoho People as the Zoho app
Destination › Zoho appOpen the Zoho app dropdown and select Zoho People. The dropdown lists every app your account is authorised for.
Zoho People not in the list?The connection must include Zoho People. Open FormBridge for Zoho → Connections, choose Edit access for the account, tick Zoho People and reauthorise. Zoho grants only the permissions asked for when a connection is made.
Selecting Zoho People as the Zoho app. Step 3: Select the module
Destination › ModuleFrom the Module dropdown, choose what the feed should do in Zoho People. Each option says both the record type and the action:
- Employees: find, then update or create
- Onboarding candidates: find, then update or create
- Leave: submit a leave request
- Your own Zoho People forms, such as Form “Asset”, Form “Travel Request” or Form “Department”, each with find, then update or create
For a staff or HR intake form, choose Employees. The list loads from your own Zoho People account, so the forms you see here are the ones your organisation has set up.
Choosing the Zoho People module. Step 4: Check the connection and set duplicate handling
Destination › Destination settings and Duplicate handlingUnder Destination settings, click Test connection to confirm FormBridge can reach the account and module you chose. Settings that do not apply to the chosen module stay hidden.
Under Duplicate handling, tick Update the matching Zoho record instead of creating a duplicate if an existing record should be updated rather than a second one created. Then click Continue.
Testing the connection and setting duplicate handling. Step 5: Map the required fields
Mapping › Field mappingOn the Mapping step, give each Zoho field a form field. Both lists load on their own: the Zoho fields come from the module you chose, and the form fields from your form.
Rows marked Required are locked, because Zoho People won’t create the record without them. For Employees those are Employee ID, First Name, Last Name and Email address; you only choose where each value comes from.
Mapping form fields to the required Zoho People fields. Step 6: Send fixed values and add more rows
Mapping › Static valueClick + Add mapping row to send more fields. To send the same value on every submission, set Source to Static value: the form field column greys out and you type the value in the Static value box instead — a nickname or a location, for example.
Adding static values with Add mapping row. Step 7: Set conditional logic (optional)
Mapping › Conditional logicConditional logic lets a feed send only the submissions you want. Turn on Only send when the conditions below match, then build your rules: conditions inside a group must all match, and a record passes if it matches any one group.
While the switch is off the feed sends every record it receives, and any rules you have written are kept but not applied. You can leave this section alone if every submission should reach Zoho People.
Read the full conditional logic guide →
Setting conditional logic for the feed. Step 8: Test and save the feed
Mapping › Test this feedClick Send test record. FormBridge sends one real record to Zoho People using the feed as last saved: static values go as they are, and mapped form fields are filled with realistic sample data, such as a valid email address and phone number. Open the module in Zoho People to check that the record arrived with the values you expect.
When the test looks right, click Save feed. The feed starts listening to the selected form straight away, so submit the real form once to confirm the whole flow.
Sending a test record, then saving the feed. Delivery logsEvery delivery, successful or failed, is recorded under FormBridge for Zoho → Logs. Failed deliveries can be sent again with Resubmit.
- One feed listens to exactly one form. If two forms should send data to Zoho People, create two feeds.
- Changing the account, app or module after mapping clears the mapping rows, so set those first.
- To see exact Zoho People field names, go to FormBridge for Zoho → Connections and click Modules & Fields for the account.
Verify the integration
- Submit the real form using an email address you can recognise.
- Check the log under FormBridge for Zoho → Logs and confirm the delivery succeeded.
- Find the record in the Zoho People module you selected.
- Check the values, including any static values.
- Test duplicate handling, if it’s on, by submitting the same details again. The existing record should update.
Troubleshooting
Pick the symptom you’re seeing to get the fix.
No record is created
- Likely cause
- A required field is unmapped, or its form field is empty.
- How to fix it
- Check the locked Required rows on the mapping step. For Employees, Employee ID, First Name, Last Name and Email address all need a value. Then open the Logs screen for the error Zoho People returned.
Zoho People missing from the dropdown
- Likely cause
- The connection was authorised before People was added.
- How to fix it
- Open Connections → Edit access for the account, tick Zoho People and reauthorise.
A form is missing from the module list
- Likely cause
- The list was loaded before the form existed in Zoho People.
- How to fix it
- Use the reload button beside the Module dropdown, then pick the form again.
Nothing reaches Zoho
- Likely cause
- Conditional logic is on and no record matches the rules.
- How to fix it
- Open the conditional logic panel and check the rules, or switch off Only send when the conditions below match to send every record.
Duplicate records
- Likely cause
- Duplicate handling is turned off in the feed.
- How to fix it
- Tick the duplicate handling checkbox on the Destination step so a matching record is updated instead.
Mapping rows cleared
- Likely cause
- The account, app or module changed after mapping.
- How to fix it
- Set the account, app and module first, then map the fields.
Still stuck? Email the failed entry from the Logs screen to support@techwavesolutions.net.
Frequently asked questions
What can a feed create in Zoho People?
A feed can find, update or create Employees and Onboarding candidates, submit a leave request, or send data to your own Zoho People forms. You pick one under Module.
Which fields are required for a Zoho People employee?
Employee ID, First Name, Last Name and Email address. All four appear as locked Required rows on the mapping step, so you only choose where each value comes from.
What does Test connection do?
It checks that FormBridge can reach the account and module you chose before you continue to the mapping step.
What does Send test record do?
It sends one real record to Zoho People using the feed as last saved. Static values are sent as they are, and mapped form fields are filled with realistic sample data such as a valid email and phone number.
Do I have to use conditional logic?
No. While the switch is off, the feed sends every record it receives, and any rules you have written are kept but not applied.
