Sending Application Complete Events Back to Snagajob
This resource provides guidance to vendors who want to send application complete conversion events back to Snagajob for campaign optimization
Last updated
Was this helpful?
This resource provides guidance to vendors who want to send application complete conversion events back to Snagajob for campaign optimization
Last updated
Was this helpful?
To send application complete events, send a POST
request to the v1/applications/completed
route with a JSON body containing an array of completion events.
Each event in the array should include a unique Snagajob applyLeadId
, timestamp
, and an optional cost
value.
The v1/applications/completed
route supports a maximum JSON data payload of 5,000 applications per request.
When sending applications, please send in batches of fewer than 5,000 applications.
Start by requesting an API Key here:
To ensure authenticity, Snagajob requires that you generate a signature (X-SAJ-Signature
) and provide the required headers as part of the request for each API call.
See Generating the X-SAJ-Signaturefor more details
ts
Yes
The click event time represented as an Epoch Unix Timestamp (seconds). All clicks are recorded in Eastern Time.
number
10111000
applyLeadId
Yes
Snagajob's tracking ID. When a job seeker is redirected from Snagajob to your job site, we include this ID in the redirect URL.
Save this ID and pass it with every event you report for that job seeker.
string
78dbe8d7-bc12-42ba-97d8-6f7236bbb009
cost
The cost of the apply (optional)
string
2.50
partnerGuid
Yes
The partners GUID for the event
string
21AVAERGHGA3
When a worker clicks the 'Apply Now' button, the Snagajob applyLeadId is added to the URL as a parameter (clickid
).
For example, the URL may look like this: https://ats.com?&applyleadid=334c870a-8049-4f4f-a7f3-d75119dd4ab8&applyintenteventid=644b5b52-34a1-4cb7-beac-996438d4cdd6&clickid=334c870a-8049-4f4f-a7f3-d75119dd4ab8&postingid=502840248
You'd set 334c870a-8049-4f4f-a7f3-d75119dd4ab8
, obtained from the clickid
parameter, as the value for applyLeadId
.
If your system requires a different parameter name to capture our value, please let us know, and we will do our best to help.
/v1/applications/completed
A key provided by Snagajob that represents the partner. Required.
The date and time of the request in the RFC1123 format (eg: Mon, 31 Oct 2022 20:23:10 GMT). Dates older then 15 minutes will be rejected.
A string specific to the request and signed with a private key as described https://docs.snagajob.com/authentication/generating-the-x-saj-signature".