Skip to Content
Candidate

Save job preferences

PUT
/developer/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.

Authorization

DeveloperKey
headerAuthorizationBearer <gm_live_...>

A GetMattered developer API key, sent as Authorization: Bearer gm_live_....

Request Body

application/json
  1. body
benefits?array<string>

Must-have job benefits

companySize?array<string>

Preferred company sizes

educationLevel?string

Minimum education level filter

excludeIndustries?array<string>

Industries to exclude from matches

experienceLevel?string

Target experience level (DEPRECATED scalar - prefer experienceLevels). When experienceLevels is present it wins; this scalar is kept so legacy mobile binaries keep working.

Value in"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?boolean

Include region-restricted remote jobs (workStyles "remote") even when specific locations are set. Does NOT control worldwide remote - see remoteGlobal.

remoteGlobal?boolean

Accept 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?boolean

Enable 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.

Itemsitems <= 5
salaryCurrency?string

Currency for the salary band (converted to USD for matching). Defaults to usd.

Value in"usd""eur""gbp""cad""aud""inr"
salaryMax?number

Maximum salary requirement

Range0 <= value
salaryMin?number

Minimum salary requirement

Range0 <= value
skills?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).

Items1 <= items <= 5
visaSponsorship?string

Visa 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.

Items1 <= items

Response Body

The preferences as saved.

application/json
  1. response

Successful API response

data*
meta?
success*true
Value intrue
Example Request
curl -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"
  ]
}'
Example Response
{
  "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
}