| Reference | Title | Source | Status | Created | |
|---|---|---|---|---|---|
| AD-123 | (Ad Sync) Señor business analyst | SEEK | Active | 2048-01-01 | |
| AD-124 | Experienced BA wanted | Job board X | Active | 2048-01-02 | |
idempotencyId is required when posting a job ad.
We recommend that you use a generate a new v4 UUID before sending the first request, and to reuse that identifier on all subsequent retries for the same job ad.
This provides a common thread across all attempts,
making it easier to manage incidents and avoid manual triage of requests that initially experienced transient errors but eventually succeeded.If your software has already posted a job ad with the same idempotencyId,
the SEEK API will return a PostPositionPayload_Conflict or PostPositionProfileForOpeningPayload_Conflict result in accordance with our mutation conflict convention.
If your software was retrying a job posting request,
you can treat the conflict result as a success as it indicates the job ad has already been posted.The SEEK API deduplicates job ads posted by your software based on their idempotencyIds.
Your software should never reuse an idempotencyId when posting a different job ad;
this may result in subsequent job ads being missed or other unexpected behaviour.
Your identifiers are isolated and will not conflict with those generated by other recruitment software providers.Ad Sync provides similar handling to ensure a single job ad exists based on a stable identifier that your software provides for a given position, seekPartnerPositionId.
Refer to Share positions for further details.The hirer experience on the SEEK Employer website is currently job ad centric rather than position centric.
Hirers that use SEEK’s Apply Form will rely on your software to implement Optimised Apply and provide a consolidated applicant list view across multiple job ads.Include consistent references across posting sources to allow your software to associate applicants across multiple job ads with the same position.