cURL
curl --request POST \ --url https://api.nuvion.tech/accounts \ --header 'Authorization: <authorization>' \ --header 'Content-Type: application/json' \ --data ' { "type": "debit", "currency": "USD", "display_name": "My Primary Account", "meta": { "purpose": "Personal expenses", "category": "primary" }, "config": { "is_overdraftable": false, "overdraft_limit": 0 } } '
{ "message": "Account created successfully", "status": 201, "data": { "account": { "id": "01HJ5G6R7MXW5ZK2QD6YA8N9F3", "entity_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F4", "type": "debit", "currency": "USD", "display_name": "My Primary Account", "meta": {}, "config": { "is_overdraftable": false, "overdraft_limit": 0 }, "created": 1693584000000, "updated": 1693584000000, "balance": { "available": 0, "current": 0, "overdraft_used": 0 } }, "entity_impact": { "entity_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F4", "total_accounts": 1, "account_type": [ "debit" ], "default_account_set": true } } }
Creates a new account for the authenticated entity.
Authorization header: Bearer {jwt or Secretkey}
The type of account to create
The three-letter ISO currency code for the account
A user-friendly name for the account
Additional metadata associated with the account
Configuration settings for the account
Show child attributes
Whether the account can be overdrawn
The maximum amount the account can be overdrawn by
Created successfully
A descriptive message indicating the result of the operation
The status of the API operation (successful, error, failed, pending)
The data returned from the operation
Details of the created account
Unique identifier for the account
Identifier of the entity that owns the account
The type of account
The currency code for the account
User-friendly name for the account
Configuration options for the account
Maximum amount the account can be overdrawn by
Timestamp when the account was created (in milliseconds since epoch)
Timestamp when the account was last updated (in milliseconds since epoch)
Current balance information for the account
Available balance that can be spent
Current total balance including pending transactions
Amount of overdraft currently being used
Additional metadata for the account
Information about how this account affects the entity
Identifier of the entity
Total number of accounts the entity now has
Types of accounts the entity has
Whether a default account has been set for the entity