# ➕ Create new PDP client

Create a new PDP client and associate it with an external reference.

This endpoint allows you to create new PDP client IDs that can be used
with other API endpoints. Each client is associated with an external reference
for easy identification in your systems.

Note: This endpoint does not require the X-PDP-Client-ID header since
it's used to create new client IDs.

Endpoint: POST /clients/pdp-clients
Version: 1.0.0
Security: APIKeyHeader

## Request fields (application/json):

  - `external_reference` (string, required)
    External reference to associate with the PDP client
    Example: "CUST-12345"

  - `client_name` (string, required)
    Human-readable name for the client
    Example: "ACME Corporation"

  - `description` (any)
    Optional description of the client
    Example: "Main client for ACME Corp operations"

## Response 201 fields (application/json):

  - `pdp_client_id` (string, required)
    Generated PDP client ID
    Example: "pdp_abc123def456"

  - `external_reference` (string, required)
    Associated external reference
    Example: "CUST-12345"

  - `client_name` (string, required)
    Client name
    Example: "ACME Corporation"

  - `status` (string, required)
    Client status
    Example: "active"

  - `created_at` (string, required)
    Creation timestamp

  - `message` (string, required)
    Success message

## Response 400 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)


## Response 409 fields