---
title: "HackerOne"
description: "Reference for the Tracecat HackerOne integration: registered actions, required secrets, expected inputs, and example workflow usage."
---

{/* Auto-generated by scripts/generate_tool_docs.py; do not edit by hand. */}
## Get program

Action ID: `tools.hackerone.get_program`

Get details of a specific program from HackerOne.

Reference: [https://api.hackerone.com/customer-resources/?python#programs-get-program](https://api.hackerone.com/customer-resources/?python#programs-get-program)

### Secrets

Required secrets:

- `hackerone`: required values `HACKERONE_API_USERNAME`, `HACKERONE_API_TOKEN`.

### Input fields

<ParamField path="program_id" type="integer" required>

The ID of the program to retrieve.

</ParamField>

## Get programs

Action ID: `tools.hackerone.get_programs`

Get a paginated list of programs from HackerOne.

Reference: [https://api.hackerone.com/customer-resources/?python#programs-get-programs](https://api.hackerone.com/customer-resources/?python#programs-get-programs)

### Secrets

Required secrets:

- `hackerone`: required values `HACKERONE_API_USERNAME`, `HACKERONE_API_TOKEN`.

### Input fields

<ParamField path="page_number" type="integer">

The page number to retrieve (starts at 1).

Default: `1`.

</ParamField>

<ParamField path="page_size" type="integer">

Number of programs per page (1-100).

Default: `25`.

</ParamField>

## Get report

Action ID: `tools.hackerone.get_report`

Get details of a specific report from HackerOne.

Reference: [https://api.hackerone.com/customer-resources/?python#reports-get-report](https://api.hackerone.com/customer-resources/?python#reports-get-report)

### Secrets

Required secrets:

- `hackerone`: required values `HACKERONE_API_USERNAME`, `HACKERONE_API_TOKEN`.

### Input fields

<ParamField path="report_id" type="integer" required>

The ID of the report to retrieve.

</ParamField>

## Get reports

Action ID: `tools.hackerone.get_reports`

Get a paginated list of reports from HackerOne.

Reference: [https://api.hackerone.com/customer-resources/?python#reports-update-weakness](https://api.hackerone.com/customer-resources/?python#reports-update-weakness)

### Secrets

Required secrets:

- `hackerone`: required values `HACKERONE_API_USERNAME`, `HACKERONE_API_TOKEN`.

### Input fields

<ParamField path="filters" type="object" required>

Filters to apply to the reports. For example, &#123;'filter[program][]': 'tracecat', 'filter[state][]': ['new', 'triaged'], 'filter[assignee][]': 'Tracecat Team'&#125;

</ParamField>

<ParamField path="page_number" type="integer">

The page number to retrieve (starts at 1).

Default: `1`.

</ParamField>

<ParamField path="page_size" type="integer">

Number of reports per page (1-100).

Default: `25`.

</ParamField>
