---
title: "Create"
method: POST
path: "/abuse_reports"
tags: ["AbuseReports"]
---

# Create

`POST /abuse_reports`

Creates a new abuse report which will be reviewed by our system and abuse response team. This API is only available to authorized accounts. Contact abuse@ngrok.com to request access

## Headers

- `ngrok-version` integer, required

## Request body

- AbuseReportCreate
  - `urls` string[], required — a list of URLs containing suspected abusive content
  - `metadata` string — arbitrary user-defined data about this abuse report. Optional, max 4096 bytes.

## Response `201`

Creates a new abuse report which will be reviewed by our system and abuse response team. This API is only available to authorized accounts. Contact abuse@ngrok.com to request access

- AbuseReport
  - `id` string — ID of the abuse report
  - `uri` string — URI of the abuse report API resource
  - `created_at` string — timestamp that the abuse report record was created in RFC 3339 format
  - `urls` string[] — a list of URLs containing suspected abusive content
  - `metadata` string — arbitrary user-defined data about this abuse report. Optional, max 4096 bytes.
  - `status` string — Indicates whether ngrok has processed the abuse report. one of `PENDING`, `PROCESSED`, or `PARTIALLY_PROCESSED`
  - `hostnames` AbuseReportHostname[] — an array of hostname statuses related to the report
    - `hostname` string — the hostname ngrok has parsed out of one of the reported URLs in this abuse report
    - `status` string — indicates what action ngrok has taken against the hostname. one of `PENDING`, `BANNED`, `UNBANNED`, or `IGNORE`

---

[API](https://skmtc.net/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.net/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/versions/1994bbb04714/schema)