Profile purchases
Profile purchases
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.
CandidateProfilePurchased event is emitted when a hirer purchases a candidate profile in Talent Search.
Create a webhook subscription to trigger an export workflow when these events occur:
CandidateProfilePurchased event looks like so:JSON
Copy
{"events": [
{
"id": "seekAnzPublicTest:event:events:N3P1rAeTfSy8UpE5p984Hd",
"type": "CandidateProfilePurchased",
"createDateTime": "2020-08-07T13:56:38.385Z",
"candidateProfileId": "seekAnzPublicTest:candidateProfile:purchased:HWxJyVNyio4JLWLmDY6eqV",
// This is only available for signed webhook subscriptions
"hirerId": "seekAnzPublicTest:organization:seek:93WyyF1h"
}
],
"subscriptionId": "seekAnzPublicTest:webhookSubscription:events:JurnLNCzY3T8wYRVLFWQNw",
"url": "https://example.com/webhook/candidate-profile-purchased",
"expireDateTime": "2019-09-13T22:16:10.593Z"
}The
candidateProfileId provided within the webhook
body is specific to that purchase event and cannot be used as a permanent
stable identifier for the candidate. The
candidateProfileId remains valid for retrieval for
a period of up to 30 days. Attempts to retrieve a CandidateProfile using a candidateProfileId older than 30 days will
result in a null response. This may also occur if the candidate has deleted
their SEEK Profile.CandidateProfile from Talent Search contains candidate information,
a URL to the candidate’s resume file,
the organization making the purchase,
and the position that the profile should be exported to in your software.It contains the following information from the candidate’s SEEK Profile:- Candidate name
- Email address
- Phone number (if provided)
- Information about the candidate’s current employment (if applicable), including employer name, role title, start date and description.
positionOrganizations.id and positionProfiles.profileId values should be used to identify the corresponding position in your software that the purchased profile should be added to.The SEEK API does not translate user input and will serve SEEK Profile information as supplied by the candidate.
As a result, your software may need to handle multilingual candidate data.The CandidateProfile object and operations are shared with the Optimised Apply use case.
See the documentation on exporting candidate profiles and exporting attachments for more information.The candidateProfile query accepts the event candidateProfileId as input:QueryVariablesResult
CopyGraphQL Explorer
query ($id: String!) {
candidateProfile(id: $id) {
candidate {
person {
name {
given
family
}
communication {
phone {
formattedNumber
}
email {
address
}
}
}
}
associatedPositionProfile {
profileId {
value
}
positionOrganizations {
id {
value
}
name
}
}
employment {
organization {
name
}
positionHistories {
start
end
title
descriptions
current
}
}
attachments {
seekRoleCode
url
}
}
}