Create Client

Endpoint

POST /clients

Authentication

Required: Authorization header with valid token

Request Body

{
  "name": "string",
  "number": "string",
  "creditLimit": "object",
  "usedLimit": "object",
  "paymentTerms": "number",
  "additionalInformation": "string",
  "frameContract": "boolean",
  "selfInsurance": "boolean",
  "pricing": "string",
  "structureId": "string",
  "externalId": "string",
  "website": "string",
  "fax": "string",
  "street": "string",
  "streetAndNumber": "string",
  "city": "string",
  "phone": "string",
  "country": "string",
  "email": "string",
  "partnerType": "enum",
  "longName": "string",
  "postalCode": "string",
  "creditworthiness": "enum",
  "status": "enum",
  "contactPersons": [
    {
      "name": "string",
      "jobTitle": "string",
      "department": "string",
      "email": "string",
      "phone": "string",
      "mobile": "string",
      "isMain": "boolean",
      "externalId": "string"
    }
  ]
}

Fields description see here

Response

Success (201)

ClientEntity Schema

Error (400)

GeneralErrorResponse Schema

Example Usage

curl -X POST "https://integration-api.ram.syniotec.com/master-data/v1/client-management/clients" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Construction Company Ltd",
    "partnerType": "INDUSTRY",
    "status": "ACTIVE"
  }'