> ## Documentation Index
> Fetch the complete documentation index at: https://devtools.waterfall.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Track account job openings

> Experimental: follow relevant hiring at companies you already care about.

<Warning>
  **Experimental.** We're exploring this monitoring feature. The endpoint and payloads below are drafts and aren't available in the live Waterfall API.
</Warning>

A new platform, data, or infrastructure role can help you understand an account's priorities. Monitor selected companies and review the job description before deciding whether the opening is relevant to your product.

## Proposed endpoint

`POST /v1/monitoring/company-job-openings`

## Example setup

```json theme={null}
{
  "domain": "northstar.example",
  "departments": ["Engineering"],
  "webhook_url": "https://your-app.example/webhooks/waterfall",
  "custom_fields": {
    "account_id": "acct_208",
    "source": "target-account-hiring"
  }
}
```

## Example finding content

This fictional `content` object describes a posting at the company being monitored:

```json theme={null}
{
  "job_title": "Senior Platform Engineer",
  "job_url": "https://northstar.example/careers/platform-engineer",
  "job_posted_at": "2026-09-28",
  "job_description": "Build and operate our platform using Kubernetes, Terraform, and OpenTelemetry. Help engineering teams improve API reliability.",
  "job_source": "Company Website",
  "country": "United States",
  "departments": [
    "Engineering"
  ],
  "seniority": "Senior"
}
```

The posting date, description, and country may be missing. This example shows only the job content. The full delivery would also identify the company being monitored.

## From a job opening to account research

Look for responsibilities, projects, or tools that relate to your product. [Enrich the account](/v1/enrich-accounts), then [find the relevant people](/v1/find-people) if the company fits.

A job description can describe a planned project, a preferred skill, or an existing stack. Review that context before treating a technology mention as evidence of adoption.
