POST | Job application

Gewijzigd op Wed, 13 Dec 2023 om 03:06 PM

POSThttps://{domeinnaam].tool2match.nl/api/jobs/apply

Base url

The base url of the acount is https://{companyname}.tool2match.nl/api. If this does not work, ask the user for the URL they use to log in. This has the same structure.

Posting to the/jobs/applyendpoint will create new candidates in the database.

Note: In the user side of TOOL2MATCH, users have the option to determine per vacancy which fields they want to request in the application form. In the event that candidate data is forwarded via the above endpoint, this feature will no longer be available.

We therefore also have the option to load TOOL2MATCH into the website via an HTML + Javascript code. This may limit the styling you can apply, but it does ensure that the dynamic part of the application form remains intact. We therefore always recommend that you investigate this option first before building the application form via APIs. Documentation about the integration of this form can be found on this page.

How to submit a job application to TOOL2MATCH

Make sure the POST message contains a JSON body containing all the data
- The fields "firstname_2", "surname_2", "email_2" and "phone" are required to be submitted.
To get around the Single Origin Policy, use a proxy script on your server side which forwards the data to TOOL2MATCH on the above URL.
Make sure to transfer files as base64 and transfer 'birthday data' in the following order "YYYY-MM-DD".

Example of JSON body

//POST  <baseurl>/jobs/apply
//body:
{
  "preferred_language" : "nl",
  "job_id" : 1,
  "firstname_2": "Klaas",
  "surname_2": "Janssen",
  "birthday": "2000-01-01",
  "gender": "male",
  "street_2": "Stationsweg",
  "number_2": "1",
  "zipcode_2": "1234AB",
  "city_2": "Amsterdam",
  "email_2": "klaasjanssen@mail.co",
  "phone": "0612346578"
  "linkedin_profile": "https://www.linkedin.com/in/klaas-janssen/",
  "salary_indication": "1234",
  "personal_note": "Geen opmerking",
  "cv": "filename":"cv.pdf",
          "filedate": "", 
  "letter": "filename": "brief.pdf", 
               "filedata": ""
}

Dynamic fields for application form

As also mentioned above, the dynamic part of the application form disappears when the application form is integrated via API's.

To keep this functionality available to users, close integration must be established with the fields below. These fields can be retrieved through this API endpoint: /api/jobs/published/{job_id} (GET).

Variabele	Description	Type of data
js_show_street_number	Show field street number	Boolean
js_show_zipcode	Show field zipcode	Boolean
js_show_city	Show field place of residence	Boolean
js_show_country	Show field country	Boolean
js_show_birthday	Show field date of birth	Boolean
js_show_gender	Show field gender	Boolean
js_show_linkedin	Show field LinkedIn	Boolean
js_show_cv	Show field cv	Boolean
js_show_letter	Show field motivation letter	Boolean
js_show_salary_indication	Show field salary indication	Boolean
js_show_personal_note	Show field personal note	Boolean
js_street_number_required	Field street number is required to be submitted	Boolean
js_zipcode_required	Field zipcode is required to be submitted	Boolean
js_city_required	Field city is required to be submitted	Boolean
js_country_required	Field coutry is required to be sumbitted	Boolean
js_birthday_required	Field birthday is required to be submitted	Boolean
js_gender_required	Field gender is required to be submitted	Boolean
js_linkedin_required	Field LinkedIn is required to be submitted	Boolean
js_cv_required	Field cv is required to be submitted	Boolean
js_letter_required	Field motivation letter is required to be submitted	Boolean
js_salary_indication_required	Field salary indication is required to be submitted	Boolean
js_personal_note_required	Field personal note is required to be submitted	Boolean