---
title: "Create a fraud network edge"
method: POST
path: "/api/admin/fraud_network/edges"
tags: ["FraudNetwork"]
---

# Create a fraud network edge

`POST /api/admin/fraud_network/edges`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/admin/fraud_network/edges`
- Auth: API key in header `x-api-key`

## Request body

- FraudNetworkEdgeCreateSchema
  - `edge_type` 'account_transfer' | 'ownership', required
  - `evidence` FraudNetworkEvidenceCreate[]
    - `audience` 'heron_internal' | 'disclosable', required
    - `detail` object
    - `kind` 'detected_money_flow' | 'detected_funding' | 'customer_reported_fraud' | 'detected_shared_identifier' | 'detected_identity_details' | 'public_record' | 'staff_note' | 'reviewer_decision', required
    - `note` string, required
    - `occurred_at` string, date-time, nullable, required
    - `refs` object
    - `reporter_identified` boolean, required
    - `reporting_user_id` integer, nullable
    - `source` string, required
    - `source_ref` object, nullable
  - `from_node_heron_id` string, required
  - `to_node_heron_id` string, required

## Response `201`

Fraud network edge created

- FraudNetworkEdgeSchema
  - `created` string, date-time
  - `created_by` string, nullable
  - `edge_type` 'account_transfer' | 'ownership'
  - `evidence` FraudNetworkEvidenceRead[]
    - `added_by` string
    - `audience` 'heron_internal' | 'disclosable'
    - `detail` object
    - `kind` 'detected_money_flow' | 'detected_funding' | 'customer_reported_fraud' | 'detected_shared_identifier' | 'detected_identity_details' | 'public_record' | 'staff_note' | 'reviewer_decision'
    - `note` string
    - `occurred_at` string, date-time, nullable
    - `refs` object
    - `retracted_at` string, date-time, nullable
    - `source` string
  - `from_node_heron_id` string
  - `heron_id` string
  - `last_updated` string, date-time
  - `to_node_heron_id` string

## Other responses

- `404`: Fraud network node not found
- `422`: Invalid fraud network edge

## Changes

- **2026-11-03** `bd8008e49534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/admin/fraud_network/edges/post.md)

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/1ec936e17fef?raw)