# Create enterprise customer

The customer will be available in all branches. The customer data must be added through the payload attribute "customfields". Each kind of data associated with a customer is a custom filed. For example: firstName, lastName, email etc. You can use the endpoint GET /customers/customfields to retrieve all available custom fields for the selected company. To create a new custom field you can use the endpoint POST customers/customfields

Endpoint: POST /v1/enterprise-customers
Version: 0.0.4
Security: BearerAuth

## Header parameters:

  - `company-id` (string)
    Company MongoDB id used in auth context.
    Example: "65f4c840b6f1a10012ab34cd"

## Request fields (application/json):

  - `customfields` (array)
    Custom field values for the appointment. Each item is a {id, value} pair.
    Example: [{"id":"62ee11aa1d66269c365407c2","value":"John"}]

  - `customfields.id` (string, required)
    Custom field definition ID.
    Example: "62ee11aa1d66269c365407c2"

  - `customfields.value` (string, required)
    Field value as string. Phone fields require JSON: {"number":"123456789","country":"DE"}.
    Example: "John"

  - `external_id` (string)
    External id.
    Example: "65f4c840b6f1a10012ab34cd"

  - `ignore_mandatory_validation` (string)
    Ignore mandatory validation.
    Example: "example"

  - `import_customer_id` (string)
    Import customer id.
    Example: "65f4c840b6f1a10012ab34cd"

## Response 201 fields (application/json):

  - `data` (object)
    Generic response data object for proxied GraphQL entities.
    Example: {"id":"65f4c840b6f1a10012ab34cd","externalId":"ext_1001","name":"Demo value"}

  - `status` (integer)
    Operation status flag.
    Example: 1

## Response 400 fields (application/json):

  - `error` (string, required)
    Error message.
    Example: "Invalid request payload"

  - `name` (string)
    Error class name.
    Example: "BadRequestError"

  - `errorCode` (string)
    Application-specific error code.
    Example: 2

  - `details` (object)
    Structured error details.
    Example: {"query":{"page":"invalid"}}

  - `extras` (object,null)
    Extra error metadata from downstream services.
    Example: {"code":"GRAPHQL_VALIDATION_FAILED"}

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message.
    Example: "Invalid request payload"

  - `name` (string)
    Error class name.
    Example: "BadRequestError"

  - `errorCode` (string)
    Application-specific error code.
    Example: 2

  - `details` (object)
    Structured error details.
    Example: {"query":{"page":"invalid"}}

  - `extras` (object,null)
    Extra error metadata from downstream services.
    Example: {"code":"GRAPHQL_VALIDATION_FAILED"}

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message.
    Example: "Invalid request payload"

  - `name` (string)
    Error class name.
    Example: "BadRequestError"

  - `errorCode` (string)
    Application-specific error code.
    Example: 2

  - `details` (object)
    Structured error details.
    Example: {"query":{"page":"invalid"}}

  - `extras` (object,null)
    Extra error metadata from downstream services.
    Example: {"code":"GRAPHQL_VALIDATION_FAILED"}