# Register an instrument for a client

Registers an instrument owned by the specified client or by one of its customers.
The request body must include either debit_card or virtual_clabe..

Endpoint: POST /v1/clients/{clientId}/instruments
Version: 1.0.0
Security: bearerAuth

## Path parameters:

  - `clientId` (string, required)
    Client identifier (UUID) under which the instrument is being registered. The actual owner will be: - The client itself, if customer_id is omitted in the request body. - The customer specified in customer_id, if provided.

## Request fields (application/json):

  - `body` (any, required) — one of (discriminator: instrumentKind):
    - debit_card:
      - `source_bank_id` (string, required)
        Issuer/processing bank ID at Finco/Finch.
        Example: "9d84b03a-28d1-4898-a69c-38824239e2b1"
      - `client_id` (string, required)
        Client UUID under which the instrument is being registered. The actual owner will be the client itself (if customer_id is omitted) or the customer specified in customer_id (if provided).
        Example: "c2d1d1e3-3340-4170-980e-e9269bbbc551"
      - `customer_id` (string)
        Optional customer UUID that will own the instrument. When provided, the instrument belongs to this customer.
        Example: "bb1e8fde-e68e-48e9-a483-d32153c752c2"
      - `type` (string, required)
        Instrument usage type. Currently only RECEIVER is accepted.
        Enum: "RECEIVER"
      - `rfc` (string, required)
        RFC tax identifier of the account or card holder. If you don't have it, you can send "ND".
        Example: "XAXX010101000"
      - `alias` (string, required)
        Human-friendly label for the instrument.
        Example: "lorem-ipsum"
      - `debit_card` (object, required)
      - `debit_card.destination_bank_id` (string, required)
        Example: "3054ff18-32a0-478d-b9fe-b5261f9a6e1f"
      - `debit_card.card_number` (string, required)
        Example: "5579072268574100"
      - `debit_card.holder_name` (string, required)
        Example: "John Smith"
    - virtual_clabe:
      - `source_bank_id` (string, required)
        Issuer/processing bank ID at Finco/Finch.
        Example: "9d84b03a-28d1-4898-a69c-38824239e2b1"
      - `client_id` (string, required)
        Client UUID under which the instrument is being registered. The actual owner will be the client itself (if customer_id is omitted) or the customer specified in customer_id (if provided).
        Example: "c2d1d1e3-3340-4170-980e-e9269bbbc551"
      - `customer_id` (string)
        Optional customer UUID that will own the instrument. When provided, the instrument belongs to this customer.
        Example: "bb1e8fde-e68e-48e9-a483-d32153c752c2"
      - `type` (string, required)
        Instrument usage type. Currently only RECEIVER is accepted.
        Enum: same as `type` in "debit_card" (1 values)
      - `rfc` (string, required)
        RFC tax identifier of the account or card holder. If you don't have it, you can send "ND".
        Example: "XAXX010101000"
      - `alias` (string, required)
        Human-friendly label for the instrument.
        Example: "lorem-ipsum"
      - `virtual_clabe` (object, required)
      - `virtual_clabe.destination_bank_id` (string, required)
        Example: "3054ff18-32a0-478d-b9fe-b5261f9a6e1f"
      - `virtual_clabe.account_number` (string, required)
        Example: "006487113111"
      - `virtual_clabe.clabe_number` (string, required)
        Example: "002118006487113111"
      - `virtual_clabe.holder_name` (string, required)
        Example: "John Smith"

## Response 200 fields (application/json):

  - `id` (string, required)
    Example: "dd7f8d89-94dd-43ca-871b-720fde378b52"

  - `bankId` (string, required)
    Example: "d3435bd9-998d-4e8a-9067-6b71d5fd3ac7"

  - `clientId` (string, required)
    Example: "c2d1d1e3-3340-4170-980e-e9269bbbc551"

  - `ownerId` (string, required)
    Identifier of the entity that owns this instrument (client or customer). When the instrument belongs to a customer, ownerId and customerId will be the same.
    Example: "c2d1d1e3-3340-4170-980e-e9269bbbc551"

  - `alias` (string, required)
    Example: "Instrumento base"

  - `type` (string, required)
    Enum: same as `type` in "debit_card" (1 values)

  - `audit` (object, required)

  - `audit.createdAt` (string, required)
    Example: "2025-05-19 19:03:51.084659-06:00"

  - `audit.updatedAt` (string, required)
    Example: "2025-05-19 19:03:51.084668-06:00"

  - `audit.deletedAt` (string,null, required)

  - `audit.blockedAt` (string,null, required)

  - `rfc` (string, required)
    Example: "XAXX010101000"

  - `customerId` (string)
    Customer who owns the instrument when applicable. Present when the instrument belongs to a customer; omitted for client-level instruments.
    Example: "bb1e8fde-e68e-48e9-a483-d32153c752c2"

  - `instrumentDetail` (any, required) — one of:
    - CardInstrumentDetail:
      - `cardNumber` (string, required)
        Example: "5579072268574100"
      - `expirationDate` (string,null)
        May be the string "None" or null when not available.
        Example: "None"
      - `holderName` (string, required)
        Example: "John Smith"
    - ClabeInstrumentDetail:
      - `accountNumber` (string, required)
        Example: "006487113111"
      - `clabeNumber` (string, required)
        Example: "002118006487113111"
      - `holderName` (string, required)
        Example: "John Smith"