Enhanced Job Posting | SEEK Developer

This content provides an early look at an upcoming extension to the SEEK API. You may use it to scope integration effort, but the features described are not fully implemented and may be adjusted ahead of a production release.Check with your SEEK contact before starting any build work described here.

Enhanced Job Posting uses a panel embedded within your software to help hirers post job ads on SEEK. The panel infers SEEK-specific inputs based on your software’s job requisition to provide hirers with a pre-filled form to post their job ad.Each job requisition in your software is posted to SEEK as a position and job ad.

Before you begin

Enhanced Job Posting will roll out in phases, starting with partners in our Partner Program. If we haven’t contacted you about this solution, do not commence your build until you receive confirmation that we can support the certification and release of your integration. We’ll get in touch with our remaining partners once Enhanced Job Posting reaches general availability.Your software requires a Job Posting relationship with a test hirer account to build and test Enhanced Job Posting. Review the Developer Dashboard hirers page and contact SEEK’s support team to configure the relationship if it is missing.To implement Enhanced Job Posting, your software will need to request both:

Browser tokens with query:enhanced-job-posting to display the panel and mutate:enhanced-job-posting to save drafts, and
Partner tokens, for querying draft job ad details and posting job ads to SEEK.

Posting a job ad also requires a current Job Posting relationship for the hirer.Once you have completed your internal build and test phases, contact SEEK’s support team to certify your integration and gain access to Enhanced Job Posting for production hirer accounts. This is a separate pre-release step to ensure integration compatibility and quality.

Integration overview

The Enhanced Job Posting panel is intended to be displayed after the hirer has created a job requisition, and has selected to post a job ad to SEEK. A typical workflow is:

Display panel: Your software displays the Enhanced Job Posting panel, passing job requisition data which will be used to pre-fill the form. The hirer then reviews and amends details within the panel.
Manage drafts: The hirer continues in your software, which triggers the panel to save the draft job ad returning a draftPositionProfileId. After every successful save, replace the stored draft ID with the newly returned ID. This draft can be queried, previewed, or resubmitted to the render function to allow a hirer to continue editing their draft. A create-scoped draft is created when no positionProfileId is provided to the panel, and an edit-scoped draft is created when a positionProfileId is provided. A create-scoped draft can post a new job ad; an edit-scoped draft can update only its source live position profile.
Post a draft job ad: When ready to post, your software calls the postPositionFromDraft mutation with a create-scoped draftPositionProfileId to post the job ad to SEEK.
Update a job ad from a draft: To allow updates to existing job ads, your software uses the same workflow. The Enhanced Job Posting panel is rendered with the existing positionProfileId to allow editing. When ready to update, your software calls the updatePositionProfileFromDraft mutation with the edit-scoped draftPositionProfileId and the live job’s positionProfileId.

Placement and UX Guidelines

The Enhanced Job Posting panel should replace any SEEK-specific forms or fields in your existing job posting flow. Display it to users after they have set general position details, selected a SEEK hirer account and any screening questions in your software. If applicable these details can be collected by your software on the same screen as the panel.If your software supports posting to multiple job boards on the same screen, keep each board’s fields in clearly separate sections. SEEK’s Enhanced Job Posting panel should be visually distinct so hirers always know which inputs apply to which board.

Display considerations

Enhanced Job Posting panel can be embedded inline (recommended), in a drawer, a popup or a separate screen. Whatever you choose, ensure the container is wide enough to accommodate SEEK’s ad product comparison table, which is optimised for five columns side by side.

Display option	Container size recommendation
Inline / separate screen	Embed at the full width of your UI
Popup / drawer	Use a minimum of 90% of screen width

Transitioning from Classic Job Posting

No migration steps are required. Jobs posted via the Classic Job Posting flow are editable in the Enhanced Job Posting panel.

Ad Sync: Transition hirers

Enhanced Job Posting: Display panel