Sending Candidate Disposition Data to Snagajob
This resource contains instructions for vendors interested in uploading a disposition data file directly to Snagajob.
Last updated
Was this helpful?
This resource contains instructions for vendors interested in uploading a disposition data file directly to Snagajob.
Last updated
Was this helpful?
Disposition data is any update to an application in your Applicant Tracking System (ATS).
We request this for our Workers. For our Workers, understanding the status of their application is crucial, so we want to keep them in the loop. When partners provide us with disposition data, we reward responsive employers with better positioning in search results, distinct badging, and exclusive inventory slots, which leads to higher application volume.
Obtain a pre-signed URL by calling our public API route.
Upload your feed file to our S3 bucket using our example format
The above response has all the necessary information to upload your CSV directly to a Snagajob S3 bucket.
Below is an example of what that request looks like:
Note: The presigned post information is only valid for 5 minutes. If you attempt to upload a file with expired presigned post information, you’ll receive an Unauthorized response from Amazon.
Upload format: .csv
Upload size: Up to 1GB of data per upload. For larger files, please break them up into multiple files.
Minimum upload frequency: Daily
Maximum upload frequency: Up to once per hour
apply_id
Yes
The unique identifier for the job application is used to reference the employer, candidate, job, and more.
This is the id
field in the Easy Apply JSON application data. (See Example JSON)
disposition_timestamp
Yes
ISO 8601 format timestamp with timezone information for when the status change occurred.
status
Yes
The status of an application.
NEW
The application arrived via Easy Apply
CONTACTED
The candidate was contacted by phone, email, etc. This status should be sent even if the application status on your ATS has not changed. Snagajob uses this as a signal to help determine employer responsiveness, influencing the rank of your client’s jobs. (See
Why should I send disposition data to Snagajob?)
INTERVIEWED
The candidate has been interviewed.
OFFERED
An offer of employment has been sent to a candidate.
HIRED
The candidate accepted an offer of employment.
REJECTED
A candidate has been explicitly rejected, or all remaining candidates rejected after the role closed.
app01
2019-01-02T01:00:00Z
NEW
/v1/presigned-s3-disposition-post
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".