---
title: "Register an instrument for a client"
method: POST
path: "/v1/clients/{clientId}/instruments"
---

# Register an instrument for a client

`POST /v1/clients/{clientId}/instruments`

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`..

## Path parameters

- `clientId` string, required

## Request body

- union
  - RegisterDebitCardRequest
    - `source_bank_id` string, required — Issuer/processing bank ID at Finco/Finch.
    - `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).
    - `customer_id` string — Optional customer UUID that will own the instrument. When provided, the instrument belongs to this customer.
    - `type` 'RECEIVER', required — Instrument usage type. Currently only `RECEIVER` is accepted.
    - `rfc` string, required — RFC tax identifier of the account or card holder. If you don't have it, you can send "ND".
    - `alias` string, required — Human-friendly label for the instrument.
    - `debit_card` DebitCardPayload, required
      - `destination_bank_id` string, required
      - `card_number` string, required
      - `holder_name` string, required
  - RegisterClabeRequest
    - `source_bank_id` string, required — Issuer/processing bank ID at Finco/Finch.
    - `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).
    - `customer_id` string — Optional customer UUID that will own the instrument. When provided, the instrument belongs to this customer.
    - `type` 'RECEIVER', required — Instrument usage type. Currently only `RECEIVER` is accepted.
    - `rfc` string, required — RFC tax identifier of the account or card holder. If you don't have it, you can send "ND".
    - `alias` string, required — Human-friendly label for the instrument.
    - `virtual_clabe` VirtualClabePayload, required
      - `destination_bank_id` string, required
      - `account_number` string, required
      - `clabe_number` string, required
      - `holder_name` string, required

## Response `200`

Instrument created

- InstrumentResponse
  - `id` string, required
  - `bankId` string, required
  - `clientId` string, required
  - `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.
  - `alias` string, required
  - `type` 'RECEIVER', required
  - `audit` object, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `deletedAt` string, nullable, required
    - `blockedAt` string, nullable, required
  - `rfc` string, required
  - `customerId` string — Customer who owns the instrument when applicable. Present when the instrument belongs to a customer; omitted for client-level instruments.
  - `instrumentDetail` union, required
    - CardInstrumentDetail
      - `cardNumber` string, required
      - `expirationDate` string, nullable — May be the string "None" or null when not available.
      - `holderName` string, required
    - ClabeInstrumentDetail
      - `accountNumber` string, required
      - `clabeNumber` string, required
      - `holderName` string, required

---

[API](https://skmtc.net/monato/apis/fincore-api.md) · [All operations](https://skmtc.net/monato/apis/fincore-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monato/fincore-api/versions/a8263ed74545/schema)