After a Legal Entity has been onboarded and its status transitions to active, you can provision an Internal Account on their behalf. An Internal Account represents a bank account or stablecoin wallet owned by your organization or your customer within Modern Treasury.

Create an Internal Account

To create an Internal Account, send a POST request to the Internal Accounts API with the legal_entity_id of the approved legal entity that you want to open the account under.

curl --request POST \
     -u ORGANIZATION_ID:API_KEY \
     --url https://app.moderntreasury.com/api/internal_accounts \
     -H 'content-type: application/json' \
     -d '{
       "name": "Customer Payment Account",
       "currency": "USD",
       "legal_entity_id": "<legal_entity_id>"
     }'

The response will include the Internal Account's id, status, account_details, and routing_details which you will need for originating and receiving payments.

Listen for Account Activation

Subscribe to internal_account webhooks to be notified when the account is activated and ready for use.

After creation, you will receive an internal_account.activated webhook once the account is fully provisioned. The webhook payload includes the account's routing and account numbers, as well as its payment capabilities.

Stablecoin Accounts

You can also provision Internal Accounts for stablecoin wallets by following the same process. The account will be assigned a wallet address instead of traditional banking details.

curl --request POST \
     -u ORGANIZATION_ID:API_KEY \
     --url https://app.moderntreasury.com/api/internal_accounts \
     -H 'content-type: application/json' \
     -d '{
       "name": "Customer Stablecoin Wallet",
       "currency": "USDC",
       "legal_entity_id": "<legal_entity_id>"
       }'

For a full list of stablecoin currencies supported see: Stablecoin Payments