# Add a new relationship

Adds a new relationship between two Verato entities (e.g., practitioner to facility, facility to organization) according to the configured relationship definitions and verbs.

Endpoint: POST /addRelationshipService
Version: 2026.1.2
Security: bearerAuth

## Request fields (application/json):

  - `auditId` (string)
    Unique audit identifier for correlating requests and responses.

  - `auditLogMap` (object)
    Map of string keys to string values.

  - `trackingId` (string)
    Optional client-defined correlation ID.

  - `content` (object)

  - `content.relationship` (object)
    Relationship between two Verato entities.

  - `content.relationship.id` (string)

  - `content.relationship.relationshipVerb` (string)

  - `content.relationship.inverseRelationshipVerb` (string)

  - `content.relationship.subjectVeratoId` (string)

  - `content.relationship.objectVeratoId` (string)

  - `content.relationship.domain` (string)

  - `content.relationship.status` (string)

  - `content.relationship.trustFactor` (string)

  - `content.relationship.startDate` (string)

  - `content.relationship.endDate` (string)

  - `content.relationship.details` (object)
    Map of string keys to arbitrary JSON values.

## Response 200 fields (application/json):

  - `auditId` (string)
    Unique audit identifier for correlating requests and responses.

  - `success` (boolean)
    Indicates whether the business operation succeeded.

  - `unparsedJson` (string)
    Raw response payload, for debugging or migration.

  - `warnings` (array)
    Non-fatal warnings generated by the operation.

  - `retryableError` (boolean)
    Indicates whether an error is transient and the request may be retried.

  - `message` (string)
    Human-readable status message.

  - `errors` (array)
    Error messages if success is false.

  - `trackingId` (string)
    Echo of the request trackingId, if provided.

  - `content` (object)

  - `content.relationship` (object)
    Relationship between two Verato entities.

  - `content.relationship.id` (string)

  - `content.relationship.relationshipVerb` (string)

  - `content.relationship.inverseRelationshipVerb` (string)

  - `content.relationship.subjectVeratoId` (string)

  - `content.relationship.objectVeratoId` (string)

  - `content.relationship.domain` (string)

  - `content.relationship.status` (string)

  - `content.relationship.trustFactor` (string)

  - `content.relationship.startDate` (string)

  - `content.relationship.endDate` (string)

  - `content.relationship.details` (object)
    Map of string keys to arbitrary JSON values.