The employer CREATE JOB function creates a new job in the authorised account.

URL

https://apprenticeshipcentral.com.au/api/employer/create/

Request

• type (string) – job. Required.
• fields (object) – fields used to populate the new item with information (most are required)
  • position_name (string) – the position title.
  • position_description (string) – the position description.
  • position_email (string) – email address.
  • position_type_id (int) – Options sourced from the list API call..
  • position_class (int) – 0 = not specified, 1 = apprenticeship, 2 = traineeship.
  • first (bool) – 1 = this is a 1st year apprenticeship, 0 = this is not a 1st year apprenticeship. Default if not set = 1.
  • second (bool) – 1 = this is a 2nd year apprenticeship, 0 = this is not a 2nd year apprenticeship. Default if not set = 0.
  • third (bool) – 1 = this is a 3rd year apprenticeship, 0 = this is not a 3rd year apprenticeship. Default if not set = 0.
  • fourth (bool) – 1 = this is a 4th year apprenticeship, 0 = this is not a 4th year apprenticeship. Default if not set = 0.
  • position_location (int) – company location id. Can be retrieved by the Employer list API call.
  • position_category (string) – category in slug format.
  • position_subcategory (string) – subcategory in slug format.
  • position_qualification (string) – qualification code. Options sourced from the list API call.
  • position_role (string) – role code. Options sourced from the list API call.
  • position_tags (string) – comma separated tag string.
  • position_drivers (int) – driver’s licence required. 0 = not specified, 1 = yes, 2 = no.
  • position_public (bool) – 1 = yes (visible), 0 – no.
  • agency_employer_id (int) – for caller use (not required – not used by AC)

Response

• response
  • success_count (int) – set to 1 if the query ran without errors.
  • error_count (int) – set to 1 if there was a query error.

• data (int) – the newly created job id.

Errors

• 201 – No valid type passed.
• 202 – Database query error – these should be reported.
• 204 – Database insert error – these should be reported.

Notes

At this point, only limited data integrity checking is performed on the create operation, so it it is up to the developer to ensure that consistent data is provided in the fields.

Return to Employer API Create