Create new job vacancy
Use this endpoint for
- Creating a new internal job vacancy in Talent Marketplace
Typical use cases
- Integrating job vacancy from an external Applicant Tracking System
Localization
- Job vacancies can be created with multiple language variants for title and description.
- System IDs are used for other meta data fields
Throttling
- 100 requests/minute
Error descriptions
| Error Types | Error Message | Error Code |
|---|---|---|
| Tenant | tenant is not an Lx-Galaxy tenant | 403 |
| Job already exists | Please pass an unique id, Job with this id already exists | 400 |
| Vacancy Request Body | ||
| External Id is missing | Id is required | 400 |
| External Id has invalid characters | Invalid external id | 400 |
| External Id length exceeds | Length of externalId exceeds limit | 400 |
| Job Description is missing | At least one job description is required | 400 |
| Job Description does not set default | Exactly one job description should be set as default to true | 400 |
| Multiple jobDescription with same language | Multiple job descriptions for the same language not allowed | 400 |
| Description is missing | Job description: description is required | 400 |
| Job Details URL is invalid | Invalid job details URL | 400 |
| Apply URL is invalid | Invalid apply URL | 400 |
| Language Code is invalid and missing | Job description: languageCode is invalid and Job description: languageCode is required | 400 |
| Job Details URL/applyURL | Either JobDetailsURL or applyURL is required | 400 |
| Status is missing | Status is required. | 400 |
| Status is invalid | Invalid job status | 400 |
| Company name length exceeds | Length of company exceeds limit | 400 |
| Start DateTime format | Invalid start date time format | 400 |
| End Date Time format | Invalid end date time format | 400 |
| Location | Only one of the location can be set to true | 400 |
| Location Id length exceeds | Length of location id exceeds limit | 400 |
| Location name length exceeds | Length of location name exceeds limit | 400 |
| City length exceeds | Length of location city exceeds limit | 400 |
| Country Code | Invalid country code | 400 |
| Region length exceeds | Length of location region exceeds limit | 400 |
| Post Code length exceeds | Length of location postCode exceeds limit | 400 |
| Workplace Model is invalid | Invalid workplacemodel | 400 |
| Job Type is invalid | Invalid jobType | 400 |
| Schedule is invalid | Invalid schedule | 400 |
Permission required
- Nil
OAuth 2.0 Scope: jobvacancy:create
Included features
- Creation of job vacancies with multi-language content
- Job vacancy created and skill/ recruiter not associated if invalid
- Invalid skill Id is found in request → added in response with 200 http status
- Invalid recruiter is found in request → added in response with 200 http status
- Invalid location ID is found in request - skipped (vacancy created and location ID not saved)