Recruit So Simple Jobs is a WordPress plugin that displays vacancies from your Recruit So Simple database and lets candidates apply directly from your website.

1. Install and set up the Recruit So Simple Jobs plugin as described below.
2. Post a vacancy: enable Data Feeds API on a vacancy record’s Share screen.
3. Applications will automatically arrive in [Candidates > Web Import].

To use the plugin, you will need a WordPress website where you can install plugins.

In Recruit So Simple, from [Settings > System Settings > Web > Advanced], you will need:

• Your JSON Data Feed URL
• Your Data Posting API URL

Install the plugin in your WordPress website

1. In WordPress admin, go to [Plugins > Add Plugin]
2. Search for Recruit So Simple Jobs
3. Click Install Now
4. Click Activate Plugin
5. Go to [Settings > Recruit So Simple Jobs] to set up the plugin.

Basic Setup

Log into your WordPress Dashboard, then go to [Settings > Recruit So Simple Jobs]:

• Add the JSON Data Feed URL
• Add the Data Posting API URL
• Set the Jobs page slug, usually jobs

A jobs page will automatically be created at yourdomain.com/jobs/

Alternatively, you can use a shortcode (see below) to insert the plugin into an existing page.

Adding the plugin to an existing WordPress Page

If you want to display your vacancies inside an existing WordPress page, add this shortcode:

[recruit_so_simple_jobs]

Refreshing Vacancies

The feed is refreshed every 30 minutes. If you need to pull fresh vacancies sooner, click Refresh Now and save.

Pretty URLs

Each vacancy gets its own URL, for example: yourdomain.com/jobs/accountant-122/.

Note: If you change the Jobs page slug, go to Settings > Permalinks in WordPress and click Save Changes once. This refreshes WordPress pretty URLs.

Page Layout

Choose your preferred layout for how vacancies are displayed:

• Card view: vacancies appear as cards in a grid.
• List view: vacancies appear in a simpler list.

Vacancies per page

Controls how many vacancies appear before pagination is shown. For example, if this is set to 6, the vacancies page will show 6 vacancies and then navigation to the next page.

Button and Pill Colour

Set the colour used by the plugin (buttons and labels). To keep styling consistent with your website, enter your website’s main colour in any of the following formats:

• A hex value, such as #0f766e (with or without #)
• An RGB value, such as rgb(15, 118, 110)
• A comma-separated RGB value, such as 15, 118, 110

You can also use the colour picker.

Hide or Show Job Fields

Use these settings to choose what details are displayed:

• Reference (Vacancy Ref)
• Location (Town, County or Hidden)
• Salary
• Salary additional info
• Permanent/contract
• Full/part time
• Holiday entitlement (shown on vacancy record’s details page only)

Hide Salary By Ref

You can hide salary from selected vacancies by adding vacancy Refs separated by commas, for example: AB12,BB34

Add replacement salary text to be shown for vacancies where the salary is hidden, for example: “Competitive rates”.

If left blank, the salary row is hidden completely.

Application Form

When a candidate applies, required fields are:

• First name
• Last name
• Phone
• Email

If a question has been set on a vacancy record’s Share screen, this is returned and added to the candidate’s Notes.

CV Uploads

Choose whether a CV is required when candidates apply.

Accepted formats: PDF, DOC and DOCX, with a maximum file size of 10MB.

Notification Email

Use Notification email if you want WordPress to send an email when an application is submitted.

Important: For reliable notification emails, configure WordPress email delivery with your email host or an SMTP plugin.

Privacy policy’s URL

If your Candidate Registration Terms text contains the words “privacy policy”, a link to your privacy policy will automatically be created.

You can set your terms in Recruit So Simple under [Settings > System Settings > Web > Advanced].

If no URL is entered, the text remains plain.

Confirmation Message

The Confirmation message is what a candidate sees after a successful application, for example: “Thank you for your application. We will be in touch soon.”

Human Verification

Human verification helps reduce spam and is applied to the vacancy application form. You can choose:

• None
• Cloudflare Turnstile
• Google reCAPTCHA v2 checkbox

Cloudflare Turnstile set up:

1. Create a Turnstile widget in Cloudflare
2. Copy the site key and secret key
3. In the plugin settings, choose Cloudflare Turnstile
4. Paste the site key and secret key
5. Save settings

Google reCAPTCHA v2 Checkbox set up:

1. Create a reCAPTCHA v2 checkbox site in Google reCAPTCHA admin.
2. Copy the site key and secret key.
3. In the plugin settings, choose Google reCAPTCHA v2 checkbox.
4. Paste the site key and secret key.
5. Save settings.

If a provider is selected, but the keys are missing, the verification widget will not be active.

Troubleshooting

Please open a support ticket from Recruit So Simple under [Dashboard > Help & Support], and one of the team will be pleased to help.

Candidate Matching helps you quickly find the most relevant candidates for a vacancy. Not just a generic AI search of your candidate CVs, it reads the vacancy details, extracts the key requirements, then searches candidate records for matching job titles, desired roles, CV skills, experience, qualifications, education, and previous roles.

The system produces a match score out of 100. This score combines AI relevance scoring with practical checks such as salary expectations, work type, location, industry, experience, and how recently the candidate record was updated. These checks can be included or excluded from Matching Settings if you want to broaden or narrow the results.

Each result includes a short explanation showing why the candidate may be a good fit, including strengths and any considerations. Candidates already on the vacancy pipeline, archived candidates, deleted records, and very weak matches are excluded from the main results.

Results are cached for speed, but you can re-match candidates at any time to refresh the shortlist.

On a vacancy record, click Matching [a] to initiate a search.

Matching Settings [b] allows you to customise the matching calculation by including or excluding:

• Industry (see below)
• Location
• Salary (candidate target salary)
• Work Type (candidate preference for full-time, part-time, perm and/or contract)
• Experience (Candidate employment history)

Results can be further filtered [c] by tag(s), candidate job title, minimum salary, when the candidate record was last updated and availability.

Results can also be filtered by candidate status and vacancy ranking (traffic light).

Use the score slider to widen or narrow the results shown.

To add a candidate to the vacancy, click the Add button.

Select records, and apply bulk actions [d].

Industry is available as a column in the vacancy and candidate grids.

Seniority

Candidate record: Employment History

Seniority levels are fixed (Junior, Mid-level, Senior, Leadership, Executive), and applied automatically for each position in a candidate’s employment history. You can review and change seniority if needed.

Seniority is not industry-specific, so just apply the level that best fits your particular sector.

Highlights

Candidate record: Employment History

Highlights are AI-generated summaries for each position on a candidate’s employment history. These can be reviewed and edited by editing the employment history entry.

Industry

Industry is assigned to both candidates and vacancies, and is used as part of the matching algorithm. It is intended as a broad classification to help improve matching accuracy, rather than as an exhaustive list of sectors.

Industry is available as a column on the Candidates and Vacancies grids, allowing you to sort and filter records by industry.

Industry is assigned automatically (see below), but can also be changed manually on:

• Candidate record: Details screen
• Vacancy record: Details screen

Industry is assigned automatically in the following situations:

• Parsing a CV in [Candidates > Add Candidate]
• Bulk importing candidates (either from a CSV file or a ZIP file containing original CVs)
• Forwarding a CV into your database using the MailDrop feature
• Adding a candidate from [Candidates > Web Import]
• Adding a vacancy by parsing a job description, or by pasting job description text into [Vacancies > Add Vacancy]
• Manually entering text into the vacancy’s Job Description (Private) field on the Details screen. NOte that sufficient text will need to be added for a more accurate result.

If preferred, Industry can be excluded from the matching criteria in the Matching settings.

The available industries are intentionally broad. If selecting manually, choose the option that best suites the candidate’s or vacancy’s primary sector.

Note: is not possible to add your own industry sectors.

AI tools can be enabled or disabled globally under [Settings > System Settings > Company Details] located in the System Features section.

AI CV Summary

When parsing a CV (see list below), an AI generated CV summary is created that includes a Professional Summary, Current Role, Qualifications, Key Skills, Achievements, and Previous Experience. This summary can be appended to the candidate record’s notes [a] for future reference or dismissed [b] if not needed.

A CV summary is generated after performing any of the following actions:

• Adding a new candidate from [Candidates > Add Candidate].
• Importing a candidate from the Web Import screen [Candidates > Web Import].
• Clicking “Update CV” on a candidate record’s Overview screen (useful when a candidate submits an updated CV).
• Clicking “Create Agency CV” from either a candidate’s Overview or Docs screen, to create your branded Agency CV.

AI Candidate Matching

After adding a candidate to a vacancy record’s Pipeline screen, click the AI Matching Summary icon [c] to generate a matching score out of 10, along with a summary of pros, cons, and a conclusion [d]. This assessment evaluates the candidate’s suitability for the role by comparing their CV with the job description.

Alternatively, you can select up to five candidates at a time and use the ‘AI Matching Summary‘ option from the Pipeline Actions menu to generate matching scores for all selected candidates simultaneously.

Once generated, the matching score is displayed next to the candidate’s name [e]. Clicking on the score allows you to review or refresh the summary – for example, if the candidate’s CV or the job description has been updated (the summary includes the date and time that it was last generated).

Using the Matching Summary for guidance, the starring system [f] can then be used to highlight the most suitable candidates. The Pipeline can be sorted by star rating, or matching score by clicking the column header.

Notes:

• AI Candidate Matching uses the Job Description (Private) field, located in the Details section of a vacancy record.
• A detailed job description and well-structured candidate CV will produce better results.
• Once generated, the AI Candidate Matching summary is saved until the candidate is either removed from the vacancy or the summary is refreshed.

AI Writing Tools

Let AI Writing Tools assist you in composing emails, texts, and more. Simply select the text you need help with and choose a writing style [g] that best suits your purpose.

AI Writing Tools can be used in the following scenarios:

• Composing an email
• Writing an SMS message
• Adding a journal entry (located on a record’s Overview screen)
• Creating a task (on a record’s Overview screen or under [Dashboard > Tasks])
• Adding or editing the Job Description (Private) (found in a vacancy record’s Details screen)
• Creating an Agency CV (from a candidate record’s Overview or Docs screen)
• Creating an Info Request from [Candidates > Info Requests]

Note: Selected text must be between 50 and 5,000 characters.

AI Generated Job Description Templates

To save time, create a job description template [h] in the Job Description (Private) field on a vacancy record’s Details screen, or from [Vacancies > Add Vacancy]. The template will be based on the vacancy’s job title, basic details such as permanent/contract, full-time/part-time, and salary requirements.

AI Generated Interview Questions

When adding a new interview to a vacancy [Vacancy > Pipeline], you can generate example questions based on the job description. These can reflect either the candidate’s perspective (questions for interviewers) or the client’s (questions for the candidate).

Use of these AI features is subject to our terms and conditions.
Please read our policies on AI use on our website.

Easily send and receive email in Recruit So Simple by connecting your Microsoft 365 account. This streamlined integration replaces the need to manually enter server details, which Microsoft no longer fully supports.

Connecting Your Microsoft Account

To connect your Microsoft 365 account:

1. Go to [Settings > My Account > Microsoft 365].
2. Click Connect to sign in and authorise your Microsoft account.
3. If prompted with the option “Consent on behalf of your organisation”, select Yes.
   This indicates you’re the Microsoft Administrator and will allow the rest of your team to authorise their own accounts independently.

Syncing Your Inbox

This step is optional and can be skipped if you only want to send email from your database. To enable email syncing, follow these steps:

1. Click the Email Sync Setup button.
2. Choose a folder to sync — typically your Outlook Inbox, or you can create a dedicated folder in Outlook specifically for syncing.

Automatic Email Journaling

Once your inbox (or selected folder) is synced, any email received from candidates or contacts will be automatically journaled to their record if the <from> address matches either their primary or alternative email address.

Important: Journals are not added immediately. For an email to be journaled:

• It must remain in the synced folder for one hour – do not move or delete it – or enough time for two sync cycles (see next points).
• Email sync runs every 20 minutes.
• Journaling occurs on the next sync cycle and only if the email is still in the synced folder.
  This helps prevent duplicate journals from being created.
• The first 10 records with a matching email address will be journaled.

Privacy Protection: You can prevent journals from being added by blacklisting specific email addresses. For example, this can help avoid the inadvertent addition of journals to records with your personal email address. You can add blocked email addresses in [Settings > System Settings > Company Details], under Auto-Journal Block List.

Sending Limit / Throttling

When you connect your Microsoft account, your email throttle is automatically set to 25 emails per minute (1,500 per hour). This helps you send bulk email efficiently while staying within Microsoft’s sending limits.

Sending up to 1,500 emails per hour can still trigger ISP spam filters. To protect your domain’s reputation, send email responsibly and avoid practices that may be flagged as spam.

You can view or change this setting via Settings > My Account > Email Settings.

Using a Third-Party SMTP Provider

If you prefer to send email through a third-party SMTP provider:

1. Go to Email Sync Setup.
2. Deselect Enable sending email via Microsoft 365.
3. Then go to Settings > My Account > Email Settings to enter your SMTP provider’s configuration details.

Notes

• Microsoft requires reauthorisation of the connection every 90 days. If this happens, simply click Connect again to reauthorise. The system will alert you if reauthorisation is needed.
• If your inbox hasn’t synced for more than 24 hours (e.g. due to expired authorisation), the system will backfill the last 72 hours of email once reconnected. After that, it resumes normal syncing of email received within the past 24 hours.

Troubleshooting for Microsoft Administrators

If there are any issues, such as users being continually asked to request consent, you may need to check the permissions for the Recruit So Simple Email Sync app in your Microsoft Admin Center:

1. From the menu on the left, go to [Applications > Enterprise Applications].
2. Click on [Consent and permissions > User consent settings]. We recommend selecting “Allow user consent for apps from verified publishers…“. There should be 7 “permissions classified as low impact”, for the app to work:
   

   

3. To add missing permissions, click Permission Classifications > Grant admin consent for [your company name] and add all seven permissions from the table below:

Security Defaults and Authenticated SMTP

Microsoft ‘Security Defaults’: If you have previously disabled Security Defaults in your Microsoft Admin Centre, this can now be re-enabled.

Authenticated SMTP: If you have previously enabled Authenticated SMTP for your users, this can now be disabled.

Goals can be displayed full page, ideal for displaying on a TV screen. To open a goal in full screen view, first generate a Goals report from [Dashboard > Reporting]. Scroll to the required goal and click on the share icon located next to the goal’s title [1].

Features include:

• Use the goal’s unique URL in any web browser on any device.*
• Real-time tracking (refreshes every 10 seconds)
• Can be switched between dark and light mode.
• Arrange browser windows to show two or more goals.

*To revoke access to previously generated full-screen goals, reset your Goals API Key in [Settings > System Settings > Goals].

Please note that when an application is received via the API, an email notification will not be generated. If an email notification is required this will need to be sent from your website/system.

The API accepts the following JSON encoded fields:

Where to find your API key

Your API key can be found in [Settings > System Settings > Web > Advanced].

There is a rate limit of 200 requests per hour.

If an invalid key is provided there will be no response from the API.

Responses

Once the data is posted then an array is returned with either a 200 Success response, or if there are any errors then these will be returned.

PHP Example Code

The following example code can be used to post to the API . The unique key should be kept hidden and not viewable in the source code of the page. Anyone with your key will be able to post to your account.

The API will return an error if invalid data is provided (for example, an invalid email address or missing first name etc).

$file = file_get_contents("cv.pdf"); 
$base64 = base64_encode($file);

$data = array(  'firstName'             => 'James',
		'lastName'		=> 'Clayson',
		'phone'			=> '01234567890',
		'email' 		=> 'james@email.com',
		'cvData' 		=>  $base64,
		'cvFilename' 	        => 'cv.pdf',
		'job' 			=> '123',
		'question' 		=> 'Do you hold a full drivers licence?',
		'answer' 		=> 'Yes'
	);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.recruitsosimple.com/post/v1/[YOUR-KEY-HERE]");
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response  = curl_exec($ch);
curl_close($ch);
print_r($response);

The Data Feeds API can be used to connect Recruit So Simple with your website, Indeed, or other compatible job board. This allows you to post vacancies, to your website and your Indeed account, directly from the vacancy record’s Share screen.

The Data Feeds API is found in [Settings > System Settings > Web > Advanced].

JSON Data Feed, XML Data Feed

The JSON [c] and XML [b] data feeds provide structured vacancy data for your website. You can enable either or both, then share the feed URLs with your web developer to review. They can decide which fits best in your website environment, and integrate as needed.

Data	JSON	XML	XML/Indeed
Job Ref
Job title
Permanent or contract
Full-time / Part-time
Start date, end date
Job description
Consultant name
Consultant email address
Salary period
Salary
Currency
Additional salary info
Town/City
County
UK postcode or US ZIP code
Country
Client’s Business Area
Business Area ID
Question text
Question required
Tags ID
Tags name
Tag category
Date added (to the database)
Date posted
Client Ref
Vacancy URL (on micro Job Board)

Adding a vacancy to the feed

Add a vacancy to the JSON, XML, and the Indeed XML feed by enabling Data Feeds API, found under Sharing Options on a vacancy record’s Share screen.

Managing candidate applications

When using the JSON or XML feed to integrate with your website, your web developer can use our Data Posting API to send candidate applications to your database.

Candidate applications via the micro Job Board are automatically sent to your database – and you’ll be notified when that happens.

In both cases, candidate applications will appear in [Candidates > Web Import] where they can be reviewed and added to your database.

Connecting with Indeed

To share your vacancies with Indeed, follow the steps below.

1. Get Your XML Feed URL

Enable the Job Board Data Feed [a] in [Settings > System Settings > Web > Advanced].

https://rss.cm/job/x/xml

To make it compatible with Indeed, simply add /indeed the end, like this:

https://rss.cm/job/x/xml/indeed

2. Submit Your Feed to Indeed

Contact Indeed support and let them know you have an XML feed for your vacancies. Provide the Indeed-compatible feed URL above. They will guide you through the process of adding the feed to your account.

3. Set Up Your Micro Job Board

To ensure candidate applications reach your database, you should also enable your micro Job Board, which is included with your Recruit So Simple account.

For setup instructions, see our documentation: Job Board & Google Jobs. Your Job Board Data Feed (without the Indeed modification) [a] is the URL for your micro Job Board. You can use the link on your website, marketing and social media.

4. Enable Job Sharing on Vacancies

Once your feed is connected and your micro Job Board is set up:

• Open a vacancy record
• Go to the Share screen
• Enable both the Job Board and Data Feeds API

This will add the vacancy to your micro Job Board (allowing candidates to apply) and the Indeed XML feed to send the vacancy details to Indeed.

5. Receive Applications

When a candidate applies, their details will appear in [Candidates > Web Import], and you’ll be notified automatically.

Bonus Tip

If you’re manually posting vacancies on Indeed or editing existing ones:

• Look for an option to set a custom application URL
• Paste in the short URL shown on the vacancy’s Share screen (visible when the Job Board option is enabled on the vacancy record’s Share screen)

This links directly to your micro Job Board vacancy page, so candidates apply through your system. Candidate applications can be processed in [Candidates > Web Import].

You can automate email, SMS messages or tasks that are triggered by certain events in the system. Events that can be used for automation are:

• Add Candidate*
• Add Client
• Add Contact
• Add Vacancy
• Candidate Status Set ‘Archive’
• Add Interview
• Interview Date Change
• Vacancy pipeline statuses, including custom statuses

Set an automated action

1. Choose which event will trigger the action.
2. Choose which action type  (Email, SMS or Task).
3. Merge fields can also be used in the subject line, as well as in the message itself.
4. The available merge fields will depend upon the chosen event.
5. Attachments, for example your terms of business, can be added to emails.
6. You can disable and enable your saved actions at any time.

You can choose to preview automated messages before they are sent, by setting the option in [Settings > My Account > General]. Previewing the email allows you to edit further, add additional attachments, or dismiss.

* When using MailDrop to forward CVs to your database the ‘Add Candidate‘ automation is not triggered by default. To trigger the ‘add candidate’ automation, “Automation” must be enabled for each user in the MailDrop settings.

Choosing a recipient for an automated email

Choose from:

• Candidate
• Client Contact
• Custom

If sending to a custom email address, you also have the option to change this when previewing a triggered email – simply start typing a name to select a contact or candidate, or enter a new email address manually. This is perfect for interview reminders when a different client contact is conducting the interview.