Save Current Search
getmattered_create_saved_searchSave current job preferences as a named search and optionally enable email alerts for new matches. Use it to store searches for later review, not to change matching preferences.
Instructions
Save the user's current job preferences as a new named saved search, the same as saving a search on the dashboard. Pass name (optional; without one, the search is named after the first role and location) and alerts_enabled (optional; true emails the user new matches for this search). It adds a search and changes nothing else; it can be removed with getmattered_delete_saved_search. Nothing is sent to any employer and nothing is spent. Do not use it to change what the user is matched with; use getmattered_update_job_preferences. Next: getmattered_list_saved_searches.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | The name of the new search, up to 120 characters. Without one, it is named after the first role and location. | |
| alerts_enabled | No | true emails the user new matches for this search, false stops the emails. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| saved | Yes | From getmattered_create_saved_search or getmattered_update_saved_search: the search after the change. | |
| action | Yes | The operation that ran: list, save, update or delete. | |
| searches | Yes | From getmattered_list_saved_searches: every saved search. | |
| deletedId | Yes | From getmattered_delete_saved_search: the search that was deleted. |