Create an instrument

Creates a new instrument, sending instrument data in the request body.

Recommended values for instrument_type include: account, crypto_address, digital_wallet, credit_card, debit_card, gift_card, voucher, check, laptop, company_computer, smartphone.

If the /instruments/create API is called for an instrument that already exists in our system (i.e. has an existing instrument_id, it is treated it as an upsert and an update on the existing instrument is performed. The response to the request will then contain the entry previously_existed: true.

Unit21 selectively ignores upserts if the request is identical to a previous request. The response to any ignored upsert will contain the field ignored: true.

To turn a placeholder instrument into an instrument in the Unit21 system, use this endpoint.

Updates to an instrument's instrument_id are not allowed.

Follow the links for more information:

Click Try It! to start a request and see the response here!