---
title: "Create Alert"
method: POST
path: "/api/alerts"
---

# Create Alert

`POST /api/alerts`

## Request

- Base URL: `https://api.findyourrolefirst.click` (the document declares no server; this is the origin it was published from)
- URL: `https://api.findyourrolefirst.click/api/alerts`
- Auth: none declared

Email new matches of this search once a day. The email costs nothing;
opening a role you haven't unlocked this month uses one credit, as in Search.

## Request body

- AlertInput: A search to email new matches of, once a day. Paging fields are ignored.
  - `query` string
  - `location` string
  - `source` 'gh' | 'ashby' | 'lever' | 'workday' | 'amazon' | 'microsoft' | 'netflix' | 'apple' | 'google' | 'meta' | 'eightfold' | 'jibe' | 'phenom' | 'atlassian' | 'successfactors' | 'radancy', nullable
  - `published_since` string, nullable
  - `discovered_since` string, nullable
  - `limit` integer
  - `offset` integer
  - `exclude` string
  - `remote` boolean
  - `posted_within_hours` integer, nullable
  - `experience` string[], nullable
  - `family` 'product_adjacent', nullable
  - `roles` string[], nullable
  - `locations` string[], nullable
  - `badges` string[], nullable
  - `focus` string[], nullable
  - `exact` boolean
  - `not_similar` string[], nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/findyourrolefirst/apis/find-your-role-first.md) · [All operations](https://skmtc.dev/findyourrolefirst/apis/find-your-role-first/llms.txt) · [OpenAPI document](https://skmtc.dev/findyourrolefirst/apis/find-your-role-first/revisions/08f3da9ec8db?raw)