customerRefId) is an optional identifier you attach through the API. Fireblocks forwards it to your connected AML/KYT provider, so you can match a transaction, wallet, or account to your own customer or internal record inside the provider’s system.
It is a reference field only. It is not a Trigger (Screening Policy) condition and does not affect any Outcome (Post-Screening Policy). It is not shared with the counterparty or receiving institution: only your own AML/KYT provider sees it. It is available through the API only, not the Console.
Choose a value
Fireblocks does not store client PII. Use an anonymized token, such as a UUID, that you map to the customer in your own systems. The value must match^[-_:a-zA-Z0-9]*$: letters, digits, hyphens, underscores, and colons only. There is no documented length limit.
Where to set it
Setting it on a vault account or deposit address requires the Admin or Non-Signing Admin role.
Which value applies
A transaction can inherit a value from several levels. For each transaction, Fireblocks uses the first value it finds, in this order:- The transaction’s own destination value.
- For incoming transactions, the deposit address’s value.
- The vault account’s value.
- An external or unmanaged wallet’s value.
- A workspace-wide default, if one is set.
DEFAULT.