Create an email alert requested by the user, up to five per account. Requires Access and confirmed email. Omitted filters match All; query defaults to empty and enabled defaults to true. Preserves the account’s global pause state.

post/me/alerts

Request

  • Base URL: https://api.hiddenjobs.dev/v1
  • URL: https://api.hiddenjobs.dev/v1/me/alerts
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.hiddenjobs.dev/v1/oauth/authorize, token URL https://api.hiddenjobs.dev/v1/oauth/token, scopes: email)

Request body

namestring required
querystring
frequency'daily' | 'weekly' required
enabledboolean
categorystring[]

Match any selected value within this filter. All removes the filter; different filters combine with AND.

employmentTypestring[]

Match any selected value within this filter. All removes the filter; different filters combine with AND.

jobTypestring[]

Match any selected value within this filter. All removes the filter; different filters combine with AND.

remoteLocationstring[]

Match any selected value within this filter. All removes the filter; different filters combine with AND.

expectedVersioninteger required

Last config.version from get_job_alerts; use 0 before the first alert. Reread after a conflict.

Response

Operation result

Changes

No recorded changes to this operation across all 1 revision of this API.