Save job preferences
Saves the candidate's job preferences the way GetMattered saves them: titles and places are matched to known ones, then the matches are rebuilt for the new search. Fields you omit stay as saved. At most 6 saves in 5 minutes per account, the app's limit. Free.
DeveloperKeyAuthorizationBearer <gm_live_...>A GetMattered developer API key, sent as Authorization: Bearer gm_live_....
application/json- body
benefits?array<string>Must-have job benefits
companySize?array<string>Preferred company sizes
educationLevel?stringMinimum education level filter
excludeIndustries?array<string>Industries to exclude from matches
experienceLevel?stringTarget experience level (DEPRECATED scalar - prefer experienceLevels). When experienceLevels is present it wins; this scalar is kept so legacy mobile binaries keep working.
"intern""entry""junior""mid""senior""lead""executive"experienceLevels?array<>Target experience levels (multi-select, new source of truth). Empty/omitted = no seniority constraint. The first element is mirrored into the deprecated scalar experienceLevel.
includeRemote?booleanInclude region-restricted remote jobs (workStyles "remote") even when specific locations are set. Does NOT control worldwide remote - see remoteGlobal.
remoteGlobal?booleanAccept worldwide "Remote - Anywhere (Global)" jobs from any region. Independent of includeRemote/workStyles "remote" (which stay region-restricted). Set via the "Remote - Anywhere (Global)" option in the location picker.
industries?array<string>Target industries
isActive?booleanEnable or disable daily matches
jobTypes?array<string>Preferred job types
locations?array<string>Preferred locations as "City, Country" or "Country" (max 5). Middle admin segments (state/province) are stripped on ingest. Placeholder values ("anywhere", "any", ...) are rejected for security (they disable location scoping and let clients harvest the full job pool). An empty array is accepted ONLY for a caller opted into remoteGlobal - worldwide remote is itself the location answer.
items <= 5salaryCurrency?stringCurrency for the salary band (converted to USD for matching). Defaults to usd.
"usd""eur""gbp""cad""aud""inr"salaryMax?numberMaximum salary requirement
0 <= valuesalaryMin?numberMinimum salary requirement
0 <= valueskills?array<string>User skills (from resume or manual entry)
targetRoles?array<>Target role titles (max 5). When present, at least one specific title is required - empty arrays and placeholder values ("anywhere", "any", ...) are rejected for security (they disable role scoping and let clients harvest the full job pool).
1 <= items <= 5visaSponsorship?stringVisa sponsorship preference
workStyles?array<>Preferred work styles (onsite/hybrid/remote) - multi-select, at least 1 required. Geo scoping is inferred from locations, NOT this field.
1 <= itemsThe preferences as saved.
application/json- response
Successful API response
data*meta?success*truetruecurl -X PUT 'https://api.getmattered.com/api/v1/developer/preferences' \
-H 'Content-Type: application/json' \
-d '{
"locations": [
"San Francisco, United States"
],
"salaryCurrency": "usd",
"salaryMax": 190000,
"salaryMin": 150000,
"targetRoles": [
"Senior Software Engineer",
"Full Stack Developer"
],
"workStyles": [
"remote",
"hybrid"
]
}'{
"data": {
"benefits": null,
"companySize": [
"startup",
"medium"
],
"createdAt": "2026-09-01T12:00:00.000Z",
"educationLevel": "bachelor",
"excludeIndustries": null,
"experienceLevel": "senior",
"experienceLevels": [
"senior"
],
"id": 311,
"includeRemote": true,
"industries": [
"Software & SaaS",
"Financial Services"
],
"isActive": true,
"jobTypes": [
"full_time"
],
"locations": [
"San Francisco, United States"
],
"remoteGlobal": false,
"salaryCurrency": "usd",
"salaryMax": 190000,
"salaryMin": 150000,
"skills": [
"TypeScript",
"React",
"Node.js",
"PostgreSQL"
],
"targetRoles": [
"Senior Software Engineer",
"Full Stack Developer"
],
"updatedAt": "2026-09-20T08:30:00.000Z",
"visaSponsorship": null,
"workStyles": [
"remote",
"hybrid"
]
},
"success": true
}Read job preferences GET
The candidate's job preferences: target titles, locations, remote, salary and the rest, in the shape GetMattered saves them. The defaults when none are saved. Free.
Read a job GET
One of the candidate's matches in full: description, pay, fit and whether GetMattered can apply to it (`canSend`). Free.