# ➕ Create a new client

Create a new client with the provided details.

Endpoint: POST /clients
Version: 1.0.0
Security: APIKeyHeader

## Request fields (application/json):

  - `organization_name` (string, required)
    Name of the organization
    Example: "Acme Corporation"

  - `contact_email` (string, required)
    Contact email for the organization
    Example: "contact@acme.com"

  - `external_ref` (string, required)
    External reference identifier
    Example: "EXT-12345"

## Response 201 fields (application/json):

  - `client` (object, required)
    Client model with all information.

  - `client.client_id` (string)
    Unique client identifier

  - `client.organization_name` (string, required)
    Name of the organization

  - `client.contact_email` (string, required)
    Contact email for the organization

  - `client.external_ref` (string, required)
    External reference identifier

  - `client.sponsor_id` (string, required)
    PDP sponsor ID from the X-PDP-Sponsor-Id header

  - `client.status` (string, required)
    Current status of the client
    Enum: "active", "inactive", "pending", "suspended"

  - `client.created_at` (string, required)
    When the client was created

  - `client.updated_at` (any)
    When the client was last updated

  - `message` (string, required)
    Response message
    Example: "Client created successfully"

## Response 400 fields (application/json):

  - `error` (string, required)

  - `code` (integer, required)

  - `trace_id` (string, required)

## Response 409 fields (application/json):

  - `error` (string, required)

  - `code` (integer, required)

  - `trace_id` (string, required)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)