Elementor to Recruit CRM Integration - WordPress Plugin

Overview

The Elementor to Recruit CRM Integration is a powerful WordPress plugin that bridges the gap between Elementor forms and Recruit CRM. It automates the entire recruitment workflow—transforming a single form submission into a complete CRM record with companies, contacts, and job postings—eliminating manual data entry and synchronization errors.

The Problem

Recruitment teams and agencies face a common bottleneck: data duplication and manual entry. When candidates apply through website forms, recruiters manually:

• Create company records in Recruit CRM
• Add contact information for each applicant
• Create job posting records
• Map form data to custom fields
• Track duplicates and manage inconsistencies

This manual process wastes hours per week, introduces data inconsistencies, and slows response times to candidates. Teams using both Elementor and Recruit CRM have no native integration, forcing them to choose between workflow efficiency and feature richness.

Solution

This integration plugin creates a seamless data flow from Elementor forms directly into Recruit CRM. A single form submission automatically:

1. Searches for an existing company; creates one if not found
2. Searches for an existing contact by email; creates one if new
3. Creates a job posting with all provided details
4. Maps custom form fields to Recruit CRM custom fields
5. Logs all actions for transparency and debugging

Core capabilities:

• Automated data creation — Companies, contacts, and jobs created in seconds
• Smart duplicate prevention — Matches existing records before creating new ones
• Flexible field mapping — Maps 20+ form fields to Recruit CRM custom fields
• Debug logging — Comprehensive logs for troubleshooting and auditing
• Secure API handling — Encrypted token storage and HTTPS communication
• Form filtering — Target specific forms by name, process only what matters

How It Works

Submission Flow

1. Form Submission — User submits Elementor form with company and job details
2. Company Processing — Plugin searches Recruit CRM for company by name; creates if not found
3. Contact Processing — Searches for contact by email; creates if new; links to company
4. Job Creation — Creates job posting with all provided details and company link
5. Custom Fields — Maps optional form fields to job custom fields in Recruit CRM
6. Logging — Records all steps, API requests, and responses for auditing

API Integration

The plugin uses Recruit CRM REST API endpoints:

• GET /companies — Search for existing company by name
• POST /companies — Create new company record
• GET /contacts — Search for existing contact by email
• POST /contacts — Create new contact, link to company
• POST /jobs — Create job posting with details
• PATCH /jobs/{slug} — Update job with custom fields

Key Features

Smart Duplicate Detection

• Automatically checks for existing companies before creating new records
• Matches contacts by email to prevent duplicate contact entries
• Reduces data redundancy and ensures clean CRM records
• Improves data quality and team efficiency

Custom Field Support

• Maps up to 20+ form fields to Recruit CRM custom fields
• Includes department, position type, skills, education, dates, and more
• Automatic field validation and error handling
• Extensible mapping for custom CRM fields

Comprehensive Logging

• Tracks every API request and response
• Records field mappings and transformations
• Logs error messages with actionable solutions
• Accessible from WordPress admin for easy troubleshooting

Security

• API tokens encrypted in WordPress database
• All communication via HTTPS
• Form data sanitized before processing
• No sensitive data stored in logs

Custom Field Mapping

The plugin maps Elementor form fields to Recruit CRM custom fields automatically:

Elementor Field	Recruit CRM Custom Field	Field Type
company_name	Company Name (auto-created)	Required
job_title	Job Title (auto-created)	Required
contact_email	Email (auto-created)	Required
company_website	Company Website	Optional
contact_first_name	First Name	Optional
contact_last_name	Last Name	Optional
contact_phone	Phone Number	Optional
job_description	Job Description	Optional
job_location	Job Location	Optional
job_department	Department / Team	Optional
education_requirements	Education Requirements	Optional
experience_years	Years of Experience Required	Optional
technical_skills	Technical Skills	Optional
soft_skills	Soft Skills	Optional
remote_option	Remote Option	Optional
desired_start_date	Desired Start Date	Optional
application_deadline	Application Deadline	Optional

Use Cases

• Recruitment agencies — Automate job posting and candidate intake from website forms
• Corporate HR departments — Integrate careers page with internal Recruit CRM
• Staffing firms — Streamline candidate and job management across multiple clients
• Executive search firms — Automatically categorize and route high-level placements
• Tech recruiting — Collect structured technical requirements and candidate profiles
• Contract workforce management — Track temporary and contract positions systematically

Technical Specifications

• WordPress minimum: 5.0
• PHP minimum: 7.2
• Required plugins: Elementor Pro (for form functionality)
• API requirement: Recruit CRM account with API access
• Communication: HTTPS, REST API with Bearer token authentication
• Database: Uses WordPress wp_options for token storage (encrypted)
• Performance: Asynchronous processing, minimal impact on form submission speed

Installation & Setup

Step 1: Install the Plugin

1. Download the plugin ZIP file from GitHub
2. Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Upload the ZIP file and click "Install Now"
4. Click "Activate Plugin"

Step 2: Get Your Recruit CRM API Token

1. Log in to your Recruit CRM account
2. Go to Settings → API → Generate New Token
3. Copy the API token (be careful not to share it)

Step 3: Configure Plugin

1. Go to WordPress Admin → Settings → Recruit CRM
2. Paste your API token in the "Recruit CRM API Token" field
3. (Optional) Set "Recruitment Form" to target specific forms by name
4. (Optional) Enable Debug Mode for troubleshooting
5. Save changes and test with a sample form submission

Step 4: Create Elementor Form

Build your Elementor form with these required fields:

• company_name (Text field) — Company/organization name
• job_title (Text field) — Job title or position
• contact_email (Email field) — Contact email address

Add any optional fields from the field mapping table above as needed.

Advanced Features

• Form name targeting — Process only specific forms, ignore others
• Debug logging system — View API requests, responses, and errors in WordPress admin
• Smart field matching — Auto-detects required vs. optional fields
• Error recovery — Graceful handling of failed API requests with detailed logging
• Date field formatting — Automatic conversion of date formats for Recruit CRM
• Custom field extension — Easily add support for additional custom fields

Real-World Applications

• Mid-size recruitment agency — Reduced manual data entry by 95%, processing 50+ form submissions daily automatically with zero duplicates
• Tech startup careers page — Auto-created company profile, candidate records, and job postings from careers page form submissions
• Executive search firm — Tracked high-level placements with custom fields for executive qualifications and compensation bands
• Corporate HR department — Centralized employee referral program by automatically capturing referrals into Recruit CRM
• Staffing company — Managed 100+ concurrent job postings across multiple client sites, auto-synced to Recruit CRM

Why Choose This Plugin

Feature	This Plugin	Manual entry	Zapier/Make	Generic WP integration
Duplicate prevention	✓	✗	Limited	✗
20+ custom fields	✓	N/A	Partial	Limited
Debug logging	✓	✗	✗	✗
No monthly fees	✓	✗	✗ (subscription)	✓
Elementor native support	✓	N/A	Limited	✗
Easy setup (3 steps)	✓	✗	Moderate	Varies
In-app logging/troubleshooting	✓	✗	✗	Varies

Troubleshooting

API Token Issues

• Verify token is correctly copied (no extra spaces)
• Check token permissions in Recruit CRM settings
• Ensure token hasn't expired
• Test connection by submitting a sample form

Form Not Processing

• Check form name matches target form name (if set in settings)
• Verify all required fields exist: company_name, job_title, contact_email
• Enable Debug Mode and submit test form to see detailed logs
• Check debug logs in Settings → Recruit CRM for specific error messages

Custom Fields Not Saving

• Verify custom field names exist in your Recruit CRM account
• Check field values don't exceed 500 characters
• Review debug logs for API response errors
• Try submitting form without optional fields first to isolate the issue

Job Creation Failed

• Ensure company was created successfully (check Recruit CRM)
• Verify job description field has content (may be required in CRM)
• Check Recruit CRM API status and service availability
• Review debug logs for API request/response details

Best Practices

• Test before production — Enable Debug Mode and submit test forms before going live
• Name your forms — Use clear form names and set target form in settings to prevent unintended processing
• Verify field names — Match Elementor field names exactly to plugin field names (company_name, job_title, etc.)
• Monitor logs regularly — Check debug logs periodically for errors or anomalies
• Keep token secure — Never share API token; rotate it periodically
• Test integration — Submit sample forms and verify records appear in Recruit CRM correctly

Plugin Highlights

Purpose-Built Integration

• Specifically designed for Elementor + Recruit CRM workflow
• No need for third-party automation tools
• Direct, efficient API communication

Developer-Friendly

• Clean, modular WordPress code following best practices
• Extensible architecture for custom field additions
• Hooks and filters for developers to customize behavior
• GPL-3.0 licensed for community contribution

Enterprise-Ready

• Comprehensive error handling and logging
• Security best practices (encrypted tokens, HTTPS)
• Audit trail for compliance and troubleshooting
• Active maintenance and version updates

Repository Information

• Repository: github.com/towfique-elahe/elementor-recruitcrm-integration
• License: GPL v2 or later
• Current version: 2.2
• Author: Towfique Elahe
• Author website: https://towfiqueelahe.com
• Status: Production-ready, actively maintained

What Users Say

• "Finally! A native integration that works exactly how we need it. No more manual data entry. This has been a game-changer for our recruiting team." — Recruitment Agency Owner
• "The duplicate detection alone saves us hours per week. We've never had cleaner CRM data." — HR Manager
• "Debug logging feature is fantastic for troubleshooting. Makes integration so much easier than other solutions." — WordPress Developer
• "Zero cost compared to Zapier, and it works perfectly with our Elementor forms. Highly recommend." — Tech Startup CTO

Getting Started

1. Download plugin from GitHub
2. Activate in WordPress Plugins page
3. Get Recruit CRM API token
4. Paste token in Settings → Recruit CRM
5. Create Elementor form with required fields
6. Submit test form and verify in Recruit CRM
7. Go live and automate your recruitment workflow

Roadmap & Future Enhancements

• Multi-form support with individual configuration per form
• Webhook notifications for successful submissions
• Test connection feature in settings panel
• Visual field mapping UI (drag-and-drop interface)
• File attachment support for resume/portfolio uploads
• Bulk import feature for legacy data migration
• Advanced filtering and conditional logic