Create Contact Person

Creates a new contact person for a specific client in the system.

Endpoint

POST /clients/{clientId}/contact-persons

Authentication

Required: Authorization header with valid token

Path Parameters

ParameterTypeRequiredDescription
clientIdUUIDYesUnique identifier of the client

Request Body

{
  "name": "string",
  "jobTitle": "string",
  "department": "string",
  "email": "string",
  "phone": "string",
  "mobile": "string",
  "isMain": "boolean",
  "externalId": "string"
}

Required Fields

  • name
  • isMain

Optional Fields

All other fields are optional.

Fields description see here: Contact Persons Model

Response

Success (201)

Returns the created contact person object.

Schema: Contact Persons Model

Error (400)

Schema: Error Response DTO

Example Usage

curl -X POST "https://integration-api.ram.syniotec.com/master-data/v1/client-management/clients/75f18aa7-b0aa-4d2c-b104-b513bec82a5f/contactPersons" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "jobTitle": "Project Manager",
    "department": "Operations",
    "email": "[email protected]",
    "phone": "+1234567890",
    "mobile": "+1234567891",
    "isMain": true
  }'