Skip to main content

Job Offer Management

What's a Job Offer

A Job Offer is a structured advertisement for an open position within an organization.

For example, if a tech company wants to hire a Backend Software Developer, they create a Job Offer containing all the relevant details, such as salary, location, required degree, and a description. If these details change, or if the position is filled or cancelled, the job opening can be updated or deleted.

A Job Offer can be active (currently published and open for public applications) or inactive.

How to create a Job Offer

To create a Job Offer, call the Create Job Offer endpoint and provide the relevant job data. You must include the employer ID for which the job offer is being created.

POST Create Job Offer

Note: All job offers are created in an inactive state. To publish them, you must have an active product; however, an active product is not required to simply create the job offer.

How to edit an existing Job Offer

Once a Job Offer is created, most of its data can be edited. Simply call the Update Job Offer endpoint using the ID of the Job Offer you wish to modify.

PUT Update Job Offer

If the job offer is currently active, any changes will be forwarded immediately to the publishing service. These updates should reflect in the public listings within a few seconds.

How to delete a Job Offer

To delete a Job Offer, call the Delete Job Offer endpoint using the ID of the Job Offer you wish to remove.

Delete Job Offer

If the job offer is active, it will automatically be unpublished before deletion, meaning the public job listing will disappear.