---
search:
  tags:
    - relations
    - POST
seo:
  description: >-
    Create a relation (scope relations:write). Runs the advisory duplicate
    check;… Reference for the POST /api/v1/relations endpoint in the Basenet
    Public API.
sidebar:
  label: >-
    Create a relation (scope relations:write). Runs the advisory duplicate
    check; send confirmDuplicates=true to create anyway after reviewing matches
    (BLI-1408).
  badge: POST
title: >-
  Create a relation (scope relations:write). Runs the advisory duplicate check;
  send confirmDuplicates=true to create anyway after reviewing matches
  (BLI-1408).
type: openapi-operation
---
Endpoint: `POST /api/v1/relations`

Authentication: `bearerAuth` (Scoped API token (bnx\_…). Required scopes are noted per operation.)

Request body (`application/json`):
- `kind` (one of `"company"`, `"contact"`, `"individual"`, `"employee"`, `"court"`, `"prosecutor"`, required)
- `departmentId` (string, required)
- `companyRelationId` (string, optional)
- `companyName` (string, optional)
- `firstName` (string, optional)
- `lastName` (string, optional)
- `email` (string, optional)
- `phone` (string, optional)
- `kvkNumber` (string, optional)
- `confirmDuplicates` (boolean, optional)

Responses:
- `201`: Created resource
- `400`: Invalid request
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `409`: Duplicate relation matches found; resubmit with confirmDuplicates=true to create anyway
- `429`: Rate limited

Response 201 body (`application/json`):
- `id` (string, required)
- `kind` (string, required)
- `systemKind` (string or null, required)
- `systemCode` (string or null, required)
- `companyName` (string or null, required)
- `firstName` (string or null, required)
- `lastName` (string or null, required)
- `email` (string or null, required)
- `phone` (string or null, required)
- `departmentId` (string or null, required)
- `accessLevelId` (string or null, required)
- `active` (boolean, required)
- `createdAt` (string, required)
- `updatedAt` (string, required)