# Create Child Client

Creates a new child client under the authenticated client (or under a visible descendant via
). The child is created for travel-data ingestion only: it inherits address, tax,
currency, and methodology defaults from its parent, but has no credentials, no billing or
purchasing capability, and no product or project access.

Submit travel data for the new client by passing its  as the  on
. The child is usable on the very next request after creation.

Requires this feature to be enabled for your account (contact us); otherwise this endpoint responds with .


Endpoint: POST /v2/clients
Security: Bearer-Auth

## Request fields (application/json):

  - `name` (string, required)
    The child client's display name.

  - `external_reference` (string)
    Your own reference for the client, unique among the children of the same parent. Generated from the name when omitted.

  - `parent_id` (string)
    The parent to create the child under. Defaults to the authenticated client; must be the authenticated client or one of its descendants.

  - `metadata` (object)
    A set of key-value pairs of yours that helps you link this record in your system.

## Response 201 fields (application/json):

  - `id` (string, required)
    The client's unique identifier (UUID). Use this value as a  or as the travel-data .

  - `name` (string,null)
    The client's display name.

  - `external_reference` (string,null)
    Your own reference for this client, unique among the children of a given parent. Generated from the name when omitted on creation.

  - `parent_id` (string,null, required)
    The UUID of this client's parent, or  for the authenticated (root) client.

  - `status` (string, required)
    The client's lifecycle status.
    Enum: "active"

  - `metadata` (object, required)
    A set of key-value pairs of yours that helps you link this record in your system.

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "invalid_params", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type", "client_not_found", "invalid_parent_client", "client_has_children", "parent_id_immutable"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "invalid_params", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type", "client_not_found", "invalid_parent_client", "client_has_children", "parent_id_immutable"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)

## Response 404 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "invalid_params", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type", "client_not_found", "invalid_parent_client", "client_has_children", "parent_id_immutable"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)

## Response 422 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "invalid_params", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type", "client_not_found", "invalid_parent_client", "client_has_children", "parent_id_immutable"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)