2025 revision guide

What’s new

Integration steps and timeline

The new Apply with SEEK

Extending your integration with the Ad Performance Panel

Step 1: Understand scope

Step 2: Request access

Step 3: Build & test

Step 4: Certification

Step 5: Release

Apply with SEEK integration requirements

Ad Performance Panel integration requirements

Developer Dashboard

Testing your build

Build & test checklists

Application complete signals

1. Candidate experience certification

2. Hirer experience certification

Best practices for a successful certification

1. Confirm your release plan

2. Submit release communications for approval

3. Confirm your release

This guide provides important information you need to understand to enable a successful Apply with SEEK Version 2 and new Ad Performance Panel build.If you are integrating Apply with SEEK for the first time, refer to the use case documentation for guidance instead.

Deprecation notice: If you currently support Apply with SEEK Version 1, note that this version will be deprecated by December 2025. To ensure you complete migration to Version 2 on time, the deadline for submitting your certification request is 31 October 2025.For technical support throughout your build, contact the SEEK Integration Service Desk.

View our feature comparison for detail on new features in the latest Apply with SEEK and how it compares to the previous version.

If you have integrated Job Posting and the new version of Apply with SEEK, you can optionally include the Ad Performance Panel in your build. This feature is optional and extends your Apply with SEEK migration with a panel that helps hirers understand how each job ad is performing. Further guidance on incorporating the Ad Performance Panel is available in this document and the Ad Performance Panel documentation.

The estimated timeline for developing, testing, and releasing Apply with SEEK and the optional Ad Performance Panel typically ranges from 4 weeks to 3 months, depending on your engineering resources, internal system integrations, and change management needs.

Step		Typical duration	Tasks
1	Understand scope	1 week	Review documentation Finalise pre-migration planning
2	Request access		Request access to start building and test your integration
3	Build & test	4 weeksApply with SEEK 5 weeksApply with SEEK+ Ad Performance Panel	Familiarise yourself with the Developer Dashboard Build required components Test end-to-end functionality
4	Certification	1–2 weeks	Submit your integration for certification to ensure compliance with our requirements and technical standards
5	Release	2–4 weeks	Provide a list of hirers currently using Job Posting, Optimised Apply, link out, and/or Apply with SEEK so we can configure their access Develop and execute a customer release plan in consultation with SEEK

Tasks in the release step can be completed in parallel with other steps.

Review Apply with SEEK and Ad Performance Panel documentation to determine the relevant use cases for your integration
Review the migration considerations and hirer identifiers documentation to finalise your integration scope
Ensure your build meets the integration requirements listed below

Agreement to terms: Compliance with the SEEK API Terms of Use
Mobile optimisation: Ensure your careers website is optimised for mobile devices
Application complete signals: Implement application complete signals for all required scenarios
Signal delivery: Implement retry logic for sending application complete signals
Hirer identifiers: Replace legacy SEEK advertiser IDs with hirer identifiers
Token handling: Support retention of seek-tokens for 180 days on draft and completed applications
Button display: Display the localised Apply with SEEK button to candidates for all positions advertised on SEEK
Button display: Display the localised Apply with SEEK button to candidates for positions not advertised on SEEK (optional)
Apply form pre-fill: Review the Profile Mapping Document in the Test Steps Workbook and pre-fill all matching profile fields on your apply form to reduce candidate effort

Test Steps Workbook

Agreement to terms: Compliance with the SEEK API Terms of Use
Panel implementation: Able to embed the panel in your web-based software
User experience review: Align your user experience with our guidelines
Source attribution: Ensure consistent tracking of application source attribution between SEEK and your software

To start your integration, you must submit a Request Access to Integrate form . Once reviewed and approved, we will send you the following resources to manage your build:

Access to the Developer Dashboard, where you can manage your SEEK API credentials as well as access features to observe and configure your integration
A set of SEEK test hirer accounts, that allow you to post hidden job ads free of charge and retrieve candidate profile information for pre-filling apply forms on your careers website

Before starting your build, familiarise yourself with the Developer Dashboard, a key tool for managing your integration. The dashboard allows you to:

View SEEK hirers that have authorized access to your software
Create and rotate your client credentials
Run Playground operations in the GraphQL Explorer

Refer to the Developer Dashboard Guide for further information:

Developer Dashboard Guide

SEEK test hirer accounts provided in Step 2 will allow you to post hidden job ads free of charge via your Job Posting integration or directly through the SEEK employer website. Test hirer accounts also allow you to retrieve candidate profile information for pre-filling apply forms on your careers website.To test your build against the acceptance criteria outlined in the checklist below, you must:

Use a test hirer account to post link out job ads to SEEK
Apply to the link out job ads with your self-created test SEEK candidate accounts
Ensure you are using the correct test hirer account whenever you supply a hirerId to the SEEK API

The following checklists outline requirements and acceptance criteria so you can align your build with our standards and best practices.

Build element	Acceptance criteria
Authentication via SEEK API	Authenticate with OAuth 2.0 client credentials Retrieve partner token to use Apply with SEEK
Link-out tracking	Accurately track the source of application and pass along all necessary parameters
Display the localised Apply with SEEK button	Display the Apply with SEEK button for all positions advertised on SEEK, regardless of whether the candidate arrived from SEEK or some other source Display the Apply with SEEK button for positions not advertised on SEEK (optional) Dynamically display the correct button image and localised label (Apply with SEEK / Jobstreet / Jobsdb) Display the button in an appropriate place on your apply form
Handle SEEK candidate authorization	Navigate candidates to the authorization page when they click on the Apply with SEEK button Track and pass along parameters from the authorization flow
Retrieve profile information and download attachments	The following criteria will be visually validated in the next step: Query only for the candidate profile fields that will be used to pre-fill your apply form Identify the type of file attachments from query results If an error occurs with the `candidateProfile` query or attachment downloads, present a new Apply with SEEK button on your apply form to allow the candidate to retry
Pre-fill apply form with profile information	Populate the apply form with all matching fields on the SEEK Profile Attach the resume where available Gracefully handle scenarios where some information may be unavailable, empty, or may have failed your form’s validation by displaying descriptive error messages to the candidate
Send application complete signal	Successfully send the application complete signal when required Pass the correct `seek-token` in all cases Register & track the result of the `sendSignal` mutation Retry sending of the application complete signal if your software receives authentication or transient server errors
Embed Ad Performance Panel (optional)	Embed the panel on the view in your software that directly corresponds to the specific SEEK job ad Accurately present the job attributes in the panel If your software supports multiple hirer accounts, refresh the panel view when switching to a different hirer account Limit viewing to only authorized users

You may optionally use our downloadable Unit Test Cases to guide your internal testing. These test cases are not used for certification in the next step.

Unit Test Cases

The table below outlines the scenarios when application complete signals must be sent and whether the application will be attributed to SEEK. This will ensure your integration is compliant and performs as expected. For further guidance on handling seek-tokens and the sendSignal mutation, refer to the application complete signals documentation.

Certification ensures your integration meets our quality and functionality standards. This process is divided into two parts, with completion of Part 1 required before your integration can progress to Part 2.Download the Test Steps Workbook to guide your testing process:

Test Steps Workbook

Create test job ads
- Follow the instructions in Part 1 of the Test Steps Workbook to create the 5 required test job ads
- Record the SEEK URL for each job ad and be ready to share them
Prepare for customer migration to the integration
- Confirm your anticipated integration release date
- Provide an updated list of hirers currently using Job Posting, Optimised Apply, link out, and/or Apply with SEEK functionality in your software
Submit your Part 1 certification request:
- Submit your request for candidate experience certification via the SEEK Integration Service Desk
- Include URLs for all test job ads created
- Include your proposed release date and list of hirers to be migrated
Feedback and confirmation
- We will apply to the submitted job ads
- Feedback will be provided via email if any issues are found
- Once issues are resolved, we will confirm readiness and provide instructions to proceed to hirer experience certification

Create video recordings
- Follow the instructions in Part 2 of the Test Steps Workbook
- Record videos demonstrating:
  The applications created against each of the test job ads
  The applications source attribution tracked in your software
  The Ad Performance Panel (if applicable)
Submit your Part 2 certification request
- Submit your request for hirer experience certification via the SEEK Integration Service Desk
Feedback and confirmation
- We will review your submitted video recordings and provide feedback via email
- Certification will be granted once all requirements are met

Use exact test data: Ensure the test data provided in the workbook is used without modification to ensure consistency and accuracy during testing
Demonstrate complete coverage: Certification requires full coverage of all test cases to confirm your integration aligns with our standards
Resolve feedback promptly: Address any issues identified by SEEK in a timely manner to avoid delays in achieving certification

Once your build has been certified, you are ready to release subject to completing the below parts.

Advise us of your planned release date
Advise us of your customer release communications approach, including when they are sent to hirers

SEEK’s Release Pack includes release messaging and branding assets, which will be made available to you once your build has startedUsing the Release Pack, you can easily develop content that showcases the new value you have created for our mutual hirers.
Before you share your content with hirers, send it to APIImplementation@seek.com.au for approval
We will review your messaging within 2 business days
Once approved, you are ready to publish it!

Candidate source

Apply with SEEK used

Send signal?

Source attributed to SEEK?

Application complete reflected in Ad Performance Panel?

SEEKwith pre-authorization

Other sourcewith SEEK job ad

Other sourcewithout SEEK job ad

On the day of release, confirm with us that the release has been successfully completed

How-to guides: Overview

2025 Apply with SEEK revision: Feature comparison