Create Contract Contact Person

Creates a new contact person for a specific contract.

Endpoint

POST /contracts/{contractId}/contact-persons

Authentication

Required: Authorization header with valid token

Path Parameters

ParameterTypeRequiredDescription
contractIduuidYesContract unique identifier

Request Body

{
  "name": "string",
  "position": "string",
  "phone": "string",
  "email": "string",
  "isMain": "boolean",
  "externalId": "string"
}

All fields are optional.

Field Descriptions:

  • name - Contact person's name
  • position - Contact person's job position or title
  • phone - Contact person's phone number
  • email - Contact person's email address (validated as email format)
  • isMain - Whether this is the primary contact person for the contract (default: false). Only one contact person per contract can be marked as main
  • externalId - External system identifier for the contact person

Response

ContactPerson Entity

Error

Error Schema

Example Usage

curl -X POST "https://integration-api.ram.syniotec.com/master-data/v1/contract-management/contracts/123e4567-e89b-12d3-a456-426614174000/contact-persons" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "position": "Site Manager",
    "phone": "+1234567890",
    "email": "[email protected]",
    "isMain": true
  }'