# Organize searches with folders

Use folders to keep workspace search history clear by campaign, segment, or review need.

Canonical URL: https://help.mjhr.ai/folders
Machine-readable page: https://help.mjhr.ai/folders/README.md
Full help context: https://help.mjhr.ai/llms-full.txt
Audience: Users

## What folders are for

Folders group saved searches inside a workspace. They are best for keeping related research together, such as a sales campaign, a customer request, or a market review.

A search can sit inside a folder or remain unfiled. Keep folder names short and practical so teammates can understand them from the sidebar or history screen.

## A simple folder workflow

- Create a folder: Open search history, enter a clear folder name, and create it before moving related searches.
- Move searches into it: Use the folder selector on each saved search to file it under the right campaign or segment.
- Rename as the work changes: Rename folders when a campaign name, account name, or review period changes.
- Archive stale folders carefully: Use Archive only when the folder and searches are no longer needed in active history.

## Good folder labels

- Use names people already say in the team, such as Q3 outreach or Riyadh clinics.
- Prefer campaign, segment, account, or time period over vague names like Research.
- Keep one idea per folder so searches do not become hard to scan later.
- Leave one-off searches unfiled until they become part of a recurring workflow.

## Before archiving

Archiving a folder removes it from active history along with the searches filed under it. Review the folder first, move any searches you still need, then archive it.

Note: If you only need to clean up a single search, archive that search instead of archiving the full folder.

## For integrations

An integration can list workspace folders and create folders for new workflows.

### Create a folder

```bash
curl -X POST "$MJHR_API_ORIGIN/v1/folders" \
  -H "Authorization: Bearer $MJHR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"name":"Q3 prospecting"}'
```