---
name: greenhouse-weekly-recruiting-report
description: "Every Monday: new applicants, interviews, offers and hires per open Greenhouse job for last week, against the week before. Use when the user asks for this, or when it runs on a schedule."
---

# Greenhouse weekly recruiting report

Every Monday: new applicants, interviews, offers and hires per open Greenhouse job for last week, against the week before.

Greenhouse has reports for all of this, and building the weekly one for a leadership meeting still means picking the report, the date range and the jobs, then copying numbers into a doc. Founders hiring their first ten people want the same four numbers per role every week, without logging in.

The agent reads last week's applications, interviews and offers through Greenhouse's Harvest API v3, groups them by job and compares with the week before. Roles where nobody new entered the funnel, or where interviews piled up without offers, stand out at a glance.

## Two ways to get the data

Use the API or MCP route when you have an MCP server, a CLI or an API token for the app. Otherwise, if you can drive a browser the user is signed in to (Claude in Chrome, a Playwright or Chrome DevTools MCP server), use the browser route. Say which one you used.

## Route A: API or MCP server

### What you need

- Harvest v3 API credentials (Configure > Dev Center > API Credential Management > Create New API Credentials, API type Harvest V3 (OAuth)) with read scopes for jobs, applications, interviews and offers, in `GREENHOUSE_CLIENT_ID` and `GREENHOUSE_CLIENT_SECRET`. List endpoints act as a Site Admin user.
- Harvest v1 and v2 were removed on August 31, 2026, so older Harvest API keys no longer work for this.

If something is missing, say what and stop; do not invent numbers.

### Steps

1. **Get a token and the open jobs** (Greenhouse): `POST https://auth.greenhouse.io/token` with your Harvest v3 client ID and secret (basic auth) and `grant_type=client_credentials`. Then list jobs with `GET /v3/jobs` and keep the open ones with their names.
2. **Count new applicants** (Greenhouse): `GET /v3/applications?created_at[gte]=<last Monday, ISO 8601>&created_at[lt]=<this Monday>&prospect=false&per_page=500`, following the `Link` header cursor (the cursor must be the only parameter on later pages). Group by `job_id`.
3. **Count interviews** (Greenhouse): `GET /v3/interviews?starts_at[gte]=<last Monday>&starts_at[lt]=<this Monday>` and keep interviews that started before this Monday with `status` `scheduled`, `awaiting_feedback`, `collect_feedback` or `complete`. Map each `application_id` to its job.
4. **Count offers and hires** (Greenhouse): `GET /v3/offers?created_at[gte]=<last Monday>&created_at[lt]=<this Monday>` for offers created, ignoring `Deprecated` versions; an offer with `status` `Accepted` and `resolved_at` last week counts as a hire.
5. **Report**: One row per open job with applicants, interviews, offers and hires, totals with the weekly change, and a line on jobs with no new applicants or with many interviews and no offers.

## Route B: the browser

### What you need

- Signed in to Greenhouse as a Site Admin or a Job Admin with the **Can view reports** permission on all open jobs; reports only include jobs the user can see.

If something is missing, say what and stop; do not invent numbers.

### Steps

Start at https://app.greenhouse.io/dashboard. The user is signed in already; never type passwords or codes, and ask if a sign-in page appears.

1. **Count new applicants per job**: Open **Reports** and the **Pipeline History per Job** report (search the report library if it is not on the first page). Set the date range to last Monday through Sunday, filter **Job status** to Open, and read the **Applied** (new applications) column per job. Run it again for the week before.
2. **Count interviews**: Open the **Interview Calendar** or **Scheduled Interviews** report for the same two weeks and count interviews per job, leaving out cancelled ones. If your library only has the per-candidate view, group by the job column after exporting.
3. **Count offers and hires**: Open the **Offer Activity** report (or **Offers** under Reports) for the week: offers created per job, and offers marked **Accepted** last week as hires, with the start date. Repeat for the week before.
4. **Report**: One row per open job with applicants, interviews, offers and hires, totals with the weekly change, and a line on jobs with no new applicants or with three or more interviews and no offer. Use **Export** on each report when a table is longer than one page.

Note: Report names in the library differ slightly between Greenhouse plans and over time; the three reports to look for are the pipeline history per job, scheduled interviews and offer activity. Prospects are excluded from pipeline reports by default, which matches the API route.

## The report

- **Totals**: new applicants, interviews, offers and hires last week, with the change.
- **Per open job**: the same four numbers.
- **Stalled roles**: jobs with no new applicants, or interviews without offers.
- **Accepted offers**: role and start date.

## Post it to Briefkin

When `BRIEFKIN_TOKEN` is set, or `~/.config/briefkin/env` exists (the installer from https://briefkin.dev/docs writes it), also send the result to the user's Briefkin board as one card. Keep the `item_key` the same on every run so the card updates in place, use a new `event_id` per run, and put today's real numbers in place of the example ones. If the request fails, say so once and carry on.

```bash
[ -n "${BRIEFKIN_TOKEN:-}" ] || . ~/.config/briefkin/env
curl -sS -X POST "${BRIEFKIN_URL:-https://briefkin.dev}/v1/events" \
  -H "authorization: Bearer $BRIEFKIN_TOKEN" \
  -H "content-type: application/json" \
  -d @- <<'JSON'
{
  "v": 1,
  "event_id": "greenhouse-weekly-recruiting-report/<date of this run, e.g. 2026-10-16>",
  "item_key": "greenhouse-weekly-recruiting-report",
  "project": "Acme Hiring",
  "source": "Greenhouse weekly recruiting report skill",
  "kind": "update",
  "title": "38 new applicants and 2 offers accepted last week",
  "summary": "**38** new applicants, **17** interviews, **3** offers and **2** hires across 4 open jobs. Support Specialist got only 4 applicants.",
  "widget": [
    {
      "type": "Grid",
      "props": {
        "columns": 4
      },
      "children": [
        {
          "type": "Stat",
          "props": {
            "label": "Applicants",
            "value": 38,
            "delta": 15
          }
        },
        {
          "type": "Stat",
          "props": {
            "label": "Interviews",
            "value": 17,
            "delta": 13
          }
        },
        {
          "type": "Stat",
          "props": {
            "label": "Offers",
            "value": 3
          }
        },
        {
          "type": "Stat",
          "props": {
            "label": "Hires",
            "value": 2,
            "tone": "ok"
          }
        }
      ]
    },
    {
      "type": "Table",
      "props": {
        "columns": [
          "Job",
          "Applicants",
          "Interviews",
          "Offers",
          "Hires"
        ],
        "align": [
          "left",
          "right",
          "right",
          "right",
          "right"
        ],
        "rows": [
          [
            "Senior Backend Engineer",
            14,
            6,
            1,
            1
          ],
          [
            "Product Designer",
            11,
            4,
            1,
            0
          ],
          [
            "Account Executive",
            9,
            5,
            1,
            1
          ],
          [
            "Support Specialist",
            4,
            2,
            0,
            0
          ]
        ]
      }
    },
    {
      "type": "Callout",
      "props": {
        "text": "Support Specialist has had under 5 applicants for three weeks. The job post may need a refresh or a new board.",
        "tone": "warn"
      }
    }
  ]
}
JSON
```

Widgets come from the Briefkin catalog (https://briefkin.dev/v1/catalog). Without a token, just give the user the report.

## Run it on a schedule

Suggested: Mondays at 8:00 (`0 8 * * 1`). From cron, with the agent signed in on that machine:

```bash
0 8 * * 1 claude -p "Run the greenhouse-weekly-recruiting-report skill"
# Codex: codex exec, Gemini CLI: gemini -p, Copilot CLI: copilot -p, OpenCode: opencode run
```

Or use the agent's own scheduler (Claude Code routines, Codex automations, Claude or ChatGPT scheduled tasks): https://briefkin.dev/skills/greenhouse-weekly-recruiting-report#schedule

Source: https://briefkin.dev/skills/greenhouse-weekly-recruiting-report
